本页目录
最小请求
一次可用的请求只需要两个字段：model 与 messages。
json
{
"model": "claude-sonnet-4-6",
"messages": [
{ "role": "system", "content": "你是一个简洁的技术助手。" },
{ "role": "user", "content": "APIONE 的 base_url 是什么？" }
]
}messages 的三种角色
systemstring设定行为与语气，放在数组最前。部分厂商内部会转成独立字段，网关自动处理。
userstring | array用户输入。多模态模型可传数组，混合文本与图片。
assistantstring模型上一轮的回复。多轮对话时把历史原样带回，服务端不保存会话。
重要
接口是无状态的。多轮对话必须由你在每次请求里回传完整 messages；上下文越长，输入 token 越多，费用也越高。
常用可选参数
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
temperature | number | 1 | 0–2，越低越确定。抽取结构化信息时建议 0。 |
max_tokens | integer | 模型上限 | 本次回复的 token 上限，用来兜住失控输出。 |
stream | boolean | false | 改为 SSE 流式返回，见流式输出。 |
tools | array | — | 函数调用定义，格式与 OpenAI 一致。 |
response_format | object | — | 约束为 JSON 或指定 schema。 |
响应结构
json
{
"id": "chatcmpl-01J8ZQ7K3M",
"object": "chat.completion",
"created": 1771286400,
"model": "claude-sonnet-4-6",
"choices": [
{
"index": 0,
"message": { "role": "assistant", "content": "https://api.apione.ai/v1" },
"finish_reason": "stop"
}
],
"usage": { "prompt_tokens": 42, "completion_tokens": 12, "total_tokens": 54 }
}id：本次补全的标识。排查问题时更有用的是响应头X-Maxx-Request-ID，凭它可以在控制台 › 用量 › 请求明细里找到这次调用。finish_reason：stop正常结束、length撞到max_tokens、tool_calls需要你执行工具后再回传。usage：计费依据，缓存命中的部分会另有prompt_tokens_details。
四个常见错误
| 现象 | 原因 | 修复 |
|---|---|---|
401 invalid API token | Key 复制时带了空格或换行 | 重新复制，或用环境变量注入 |
404 not_found | base_url 少了 /v1 | 确认是 https://api.apione.ai/v1 |
400 model_not_supported | 模型 ID 拼错，或写成了别处的叫法 | 用 GET /v1/models 核对可用 ID |
| 回复被截断 | max_tokens 太小 | 调大，或检查 finish_reason |
接下来
- Reference › POST /chat/completions：完整参数表。
- 错误码：状态码与重试策略。
联系我们
文档没写清楚，或者需要人工协助？按问题类型选一个渠道即可。