一次接入，跑通 Chat Completions 与 Responses 两套协议

Authorization: Bearer $ARK_API_KEY
Content-Type: application/json

curl https://ark.cn-beijing.volces.com/api/v3/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ARK_API_KEY" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "Hello!"}
    ]
  }'

{
  "choices": [
    {
      "finish_reason": "stop",
      "index": 0,
      "message": {
        "content": "Hello! How can I help you today?",
        "role": "assistant"
      }
    }
  ],
  "created": 1742631811,
  "id": "0217426318107460cfa43dc3f3683b1de1c09624ff49085a456ac",
  "model": "deepseek-v4-flash",
  "object": "chat.completion",
  "usage": {
    "completion_tokens": 9,
    "prompt_tokens": 19,
    "total_tokens": 28,
    "prompt_tokens_details": { "cached_tokens": 0 },
    "completion_tokens_details": { "reasoning_tokens": 0 }
  }
}

curl https://ark.cn-beijing.volces.com/api/v3/responses \
  -H "Authorization: Bearer $ARK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-1-flash-260910",
    "input": "分析这段代码的性能瓶颈",
    "reasoning": {"effort": "high"},
    "max_output_tokens": 131072
  }'

curl https://ark.cn-beijing.volces.com/api/v3/responses/{response_id} \
  -H "Authorization: Bearer $ARK_API_KEY"

{
  "thinking": {"type": "enabled"},
  "reasoning_effort": "low"
}

curl https://ark.cn-beijing.volces.com/api/v3/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ARK_API_KEY" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [
      {"role": "user", "content": "常见的十字花科植物有哪些？"}
    ],
    "stream": true,
    "stream_options": {"include_usage": true}
  }'

data: {"choices":[{"delta":{"content":"","reasoning_content":"用户","role":"assistant"},"index":0}],"object":"chat.completion.chunk"}

...（思维链片段）...

data: {"choices":[{"delta":{"content":"十字","role":"assistant"},"index":0}],"object":"chat.completion.chunk"}

...（回答片段）...

data: {"choices":[{"delta":{"content":"","finish_reason":"stop","role":"assistant"},"index":0}]}

data: [DONE]

{
  "response_format": {
    "type": "json_schema",
    "json_schema": {
      "name": "person_info",
      "description": "提取人物信息",
      "strict": true,
      "schema": {
        "type": "object",
        "properties": {
          "name": {"type": "string", "description": "姓名"},
          "age": {"type": "integer", "description": "年龄"}
        },
        "required": ["name", "age"]
      }
    }
  }
}

{
  "text": {
    "format": {
      "type": "json_schema",
      "name": "person_info",
      "description": "提取人物信息",
      "strict": true,
      "schema": {
        "type": "object",
        "properties": {
          "name": {"type": "string", "description": "姓名"},
          "age": {"type": "integer", "description": "年龄"}
        },
        "required": ["name", "age"]
      }
    }
  }
}

curl https://ark.cn-beijing.volces.com/api/v3/chat/completions \
  -H "Authorization: Bearer $ARK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-1-flash-260910",
    "messages": [
      {
        "role": "user",
        "content": [
          {"type": "text", "text": "这张图片里有什么？"},
          {
            "type": "image_url",
            "image_url": { "url": "https://example.com/image.jpg", "detail": "high" }
          }
        ]
      }
    ]
  }'

"input": [
  {
    "type": "message",
    "role": "user",
    "content": [
      {"type": "input_text", "text": "描述这张图片"},
      {"type": "input_image", "image_url": "https://..."}
    ]
  }
]

{
  "input": [
    {
      "type": "function_call_output",
      "call_id": "call_abc123",
      "output": "{\"temperature\":\"18~28℃\"}"
    }
  ]
}

# 第一轮
resp = client.responses.create(
    model="deepseek-v4-1-flash-260910",
    input="我叫小明",
)

# 第二轮：传入 previous_response_id，模型自动继承上下文
resp2 = client.responses.create(
    model="deepseek-v4-1-flash-260910",
    input="我叫什么名字？",
    previous_response_id=resp.id,
)

{
  "caching": {"type": "enabled"}
}

{
  "error": {
    "code": "错误码",
    "message": "错误描述"
  }
}

import os
from volcenginesdkarkruntime import Ark

client = Ark(
    base_url="https://ark.cn-beijing.volces.com/api/v3",
    api_key=os.getenv("ARK_API_KEY"),
)

# 非流式调用
completion = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[
        {"role": "system", "content": "你是一个有帮助的助手。"},
        {"role": "user", "content": "你好"},
    ],
    thinking={"type": "enabled"},  # 开启深度思考（默认开启）
)
print(completion.choices[0].message.content)
# 思维链内容：completion.choices[0].message.reasoning_content

import os
from volcenginesdkarkruntime import Ark

client = Ark(
    base_url="https://ark.cn-beijing.volces.com/api/v3",
    api_key=os.getenv("ARK_API_KEY"),
)

# 非流式调用
response = client.responses.create(
    model="deepseek-v4-flash",
    input="你好",
    thinking={"type": "enabled"},
)
print(response.output[0].content[0].text)