API Documentation

Base URL

Authentication

在请求头中传入 API Key：

Authorization: Bearer sk-your-api-key

可用模型

🧠 深度思考   🖼️ 图片理解   🎬 视频理解   💻 编程加强

所有模型均支持 256k 上下文。 查看模型对比 →

POST /v1/chat/completions

完全兼容 OpenAI SDK，支持流式和非流式。

cURL

curl https://joapiai.xin/v1/chat/completions \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seed-2-0-lite",
    "messages": [{"role": "user", "content": "Hello!"}],
    "stream": false
  }'

Python (openai SDK)

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-key",
    base_url="https://joapiai.xin/v1"
)

# Non-streaming
resp = client.chat.completions.create(
    model="doubao-seed-2-0-lite",
    messages=[{"role": "user", "content": "Write a haiku about the ocean"}]
)
print(resp.choices[0].message.content)

# Streaming
for chunk in client.chat.completions.create(
    model="doubao-seed-2-0-mini",
    messages=[{"role": "user", "content": "Count to 5"}],
    stream=True
):
    print(chunk.choices[0].delta.content or "", end="", flush=True)

🧠 reasoning_effort — 深度思考控制

所有 Doubao Seed 2.0 模型均支持 4 档思考深度，默认不开启思考。

resp = client.chat.completions.create(
    model="doubao-seed-2-0-lite",
    messages=[{"role": "user", "content": "Solve: 3x + 5 = 20"}],
    extra_body={"reasoning_effort": "medium"}   # minimal | low | medium | high
)
print(resp.choices[0].message.content)

注：thinking token 已计入输出 token 计费。

🖼️ 图片 / 视频理解

在 messages 的 content 里传入 image_url，格式与 OpenAI Vision 完全一致。

resp = client.chat.completions.create(
    model="doubao-seed-2-0-lite",
    messages=[{
        "role": "user",
        "content": [
            {"type": "image_url", "image_url": {"url": "https://example.com/image.jpg"}},
            {"type": "text",      "text": "What is in this image?"}
        ]
    }]
)
print(resp.choices[0].message.content)

💻 接入 Claude Code / Cursor / Cline

doubao-seed-2-0-code 可直接替代 Claude Sonnet，接入主流 AI 编程工具，价格是 Claude Sonnet 的 1/2。

Claude Code

# ~/.claude/settings.json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-your-joapi-key",
    "ANTHROPIC_BASE_URL": "https://joapiai.xin/v1",
    "ANTHROPIC_MODEL": "doubao-seed-2-0-code"
  }
}

Cursor / Cline / OpenAI-compatible tools

Base URL : https://joapiai.xin/v1
API Key  : sk-your-joapi-key
Model    : doubao-seed-2-0-code

GET /v1/models

curl https://joapiai.xin/v1/models \
  -H "Authorization: Bearer sk-your-key"

错误码