豆包网页版免费额度说明：问答与语音交互随手可用

网页版直接在输入框里提问即可，不需要配置任何地址；下面说的是通过 API 调用的方式。接口兼容 OpenAI 格式，base_url 形态固定为 https://ark.cn-beijing.volces.com/api/v3。模型名在方舟控制台的模型列表里查，常见有 doubao-pro-32k、doubao-lite-32k 等，具体名称以控制台实际显示为准；如果控制台给出的是 ep- 开头的接入点 ID，就把请求里的 model 换成那个 ID。

用 curl 直接发一次对话补全请求

curl https://ark.cn-beijing.volces.com/api/v3/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ARK_API_KEY" \
  -d '{
    "model": "doubao-pro-32k",
    "messages": [
      {"role": "system", "content": "你是一个简洁的中文助手"},
      {"role": "user", "content": "用一句话介绍豆包"}
    ],
    "temperature": 0.7,
    "max_tokens": 512,
    "stream": false
  }'

用 Python 调同样的接口

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["ARK_API_KEY"],
    base_url="https://ark.cn-beijing.volces.com/api/v3",
)

resp = client.chat.completions.create(
    model="doubao-pro-32k",
    messages=[
        {"role": "system", "content": "你是一个简洁的中文助手"},
        {"role": "user", "content": "写三条给个人站长的省钱建议"},
    ],
    temperature=0.7,
    max_tokens=512,
)

print(resp.choices[0].message.content)

关键参数：model 必填，填模型名或接入点 ID；messages 是按角色排列的数组，system 放人设与约束，user 放具体问题，多轮对话就把历史消息按顺序带上；temperature 控制发散程度，问答类取 0.3 到 0.7 更稳；max_tokens 限制回复长度，会直接影响计费；stream 设为 true 可以边生成边返回。回复正文在 choices[0].message.content，本次消耗看 usage 里的 total_tokens。

额度耗尽与限流的典型表现：返回 HTTP 429，或错误体里出现 QuotaExceeded、RateLimitExceeded 一类错误码；也可能是 401 提示鉴权失败、404 提示模型不存在。排查顺序建议如下：

• 先看请求头是否为 Authorization: Bearer 你的密钥，密钥有没有多余空格，是否误把网页版账号当成密钥；
• 再核对 model 与控制台里的模型 ID 或接入点 ID 是否完全一致，接入点是否处于运行状态；
• 然后打开控制台的用量与资源包页面，确认赠送额度是否用完或已过期、账户是否欠费；
• 最后看并发，单账号并发超限同样返回 429，在代码里加指数退避重试并把并发压下来再试。