Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.focusapi.cn/llms.txt

Use this file to discover all available pages before exploring further.

端点

POST /v1/chat/completions
Base URL:https://api.FocusAPI.com/v1

请求头

必填说明
AuthorizationBearer sk-your-api-key
Content-Typeapplication/json

请求体(常用字段)

字段类型说明
modelstring模型 ID,见模型广场
messagesarray对话消息列表,rolesystem / user / assistant
streambooleantrue 时以 SSE 流式返回
temperaturenumber采样温度,可选
max_tokensinteger最大生成 token 数,可选

最小示例

{
  "model": "gpt-4o-mini",
  "messages": [
    { "role": "user", "content": "你好" }
  ]
}
完整可复制命令见 快速开始

流式输出

设置 "stream": true 后,响应为 Server-Sent Events (SSE),每行以 data: 开头。 Python SDK 示例:
stream = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "你好"}],
    stream=True,
)
for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")
流式请求请设置合理的客户端读超时;长时间无数据可能遇到 524 超时

响应(非流式)

成功时 HTTP 200,JSON 结构兼容 OpenAI,例如:
{
  "id": "chatcmpl-xxx",
  "object": "chat.completion",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "..." },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 10,
    "completion_tokens": 20,
    "total_tokens": 30
  }
}
usage 用于计费参考,具体扣费规则见 计费说明

错误

状态码文档
401未授权
429限流
524超时

按提供商查阅