## 创建响应
`POST /v1/responses`
```bash cURL theme={null}
curl --request POST \
--url https://www.anyfast.ai/v1/responses \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-6-astra",
"instructions": "你是一名资深可靠性工程师。",
"input": "审查这个重试方案并给出安全的实现计划。",
"reasoning": { "effort": "high", "summary": "auto" },
"text": { "verbosity": "medium" },
"max_output_tokens": 4096,
"store": true
}'
```
## 请求头
Bearer 鉴权，格式为 `Bearer YOUR_API_KEY`。
数据交换格式。
## 请求体
AnyFast 模型 ID，固定为 `gpt-6-astra`。
文本，或由消息、图片、文件和工具结果组成的有序列表。
插入模型上下文的 System 或 Developer 指令。
推理配置。
`low`、`medium`、`high`、`xhigh` 或 `max`。不支持 `none` 和 `minimal`。
`auto`、`concise` 或 `detailed`。
`auto`、`current_turn` 或 `all_turns`。
使用 `standard`。当前 AnyFast 路由未开放 GPT-6 Astra Pro 模式。
可见输出和推理 Token 的总上限，最大为 `128000`。
`low`、`medium` 或 `high`。
附加响应数据。使用 `reasoning.encrypted_content` 返回加密推理项。不要使用 `message.output_text.logprobs`。
改善相关请求缓存匹配的稳定键。
提示词缓存选项。`mode` 选择隐式或显式断点；`ttl` 当前支持 `30m`；`comparison_response_id` 用于请求比较诊断。
`implicit` 或 `explicit`。
当前仅支持 `30m`。
标记显式可复用提示词前缀边界。使用 `{ "mode": "explicit" }`。
应用定义的字符串键值元数据。
是否通过 SSE 流式返回响应事件。
控制流式事件混淆。
控制上游是否保存响应。AnyFast 不提供响应查询端点。
当前 AnyFast 路由使用 `disabled`。
不要传入 `temperature`、`top_p` 或 `top_logprobs`。GPT-6 Astra 的 `include` 也不支持 `message.output_text.logprobs`。
AnyFast 不提供 Responses 查询、Conversations 或 Vector Stores 管理端点。请勿使用 `background`、`conversation`、`previous_response_id`、已保存提示词引用或 `configuration_update`。
## 响应
```json 200 theme={null}
{
"id": "resp_01astraexample",
"object": "response",
"created_at": 1788460800,
"completed_at": 1788460802,
"model": "gpt-6-astra",
"status": "completed",
"output": [
{ "id": "rs_01reasoning", "type": "reasoning", "summary": [] },
{
"id": "msg_01astraexample",
"type": "message",
"status": "completed",
"role": "assistant",
"content": [{
"type": "output_text",
"text": "使用有界指数退避、幂等键，并确保只有一个重试执行方。",
"annotations": []
}]
}
],
"output_text": "使用有界指数退避、幂等键，并确保只有一个重试执行方。",
"usage": {
"input_tokens": 38,
"input_tokens_details": { "cached_tokens": 0, "cache_write_tokens": 0 },
"output_tokens": 124,
"output_tokens_details": { "reasoning_tokens": 82 },
"total_tokens": 162
},
"error": null,
"incomplete_details": null
}
```
响应 ID。
固定为 `response`。
`queued`、`in_progress`、`completed`、`incomplete`、`failed` 或 `cancelled`。
按顺序返回的推理、消息和工具调用输出项。
可用时聚合返回文本输出。
输入、输出、缓存写入、缓存命中和推理 Token 用量。
响应未完整结束的原因。
响应失败时的错误信息。
## 创建响应
`POST /v1/responses`
```bash cURL theme={null}
curl --request POST \
--url https://www.anyfast.ai/v1/responses \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-6-astra",
"input": [{
"role": "user",
"content": [
{ "type": "input_text", "text": "对照架构图和部署说明，列出冲突。" },
{ "type": "input_image", "image_url": "data:image/png;base64,", "detail": "high" },
{ "type": "input_file", "filename": "deployment-notes.pdf", "file_data": "data:application/pdf;base64," }
]
}],
"reasoning": { "effort": "high" }
}'
```
## 请求体
固定为 `gpt-6-astra`。
有序的 Responses API 输入项。
`user`、`assistant`、`system` 或 `developer`。
文本、图片或文件内容块。
`input_text`、`input_image` 或 `input_file`。
`input_text` 内容块中的文本。
`input_image` 内容块的公开 URL 或 Data URL。
`auto`、`low` 或 `high`。
内联文件数据的文件名。
包含 Base64 编码内联文件数据的 Data URL。
公开图片 URL 必须允许服务端下载；也支持 Data URL 和内联文件。GPT-6 Astra 不支持音频和视频输入模态。
## 响应
```json 200 theme={null}
{
"id": "resp_01visionexample",
"object": "response",
"model": "gpt-6-astra",
"status": "completed",
"output": [{
"id": "msg_01visionexample",
"type": "message",
"status": "completed",
"role": "assistant",
"content": [{
"type": "output_text",
"text": "架构图存在两个重试执行方，而部署说明要求只能有一个。",
"annotations": []
}]
}],
"usage": { "input_tokens": 842, "output_tokens": 67, "total_tokens": 909 }
}
```
输出项类型，例如 `message` 或 `reasoning`。
内容类型，例如 `output_text`。
生成的文本。
可用时返回引用和其他标注。
## 创建响应
`POST /v1/responses`
```bash cURL theme={null}
curl --request POST \
--url https://www.anyfast.ai/v1/responses \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-6-astra",
"input": "对部署风险进行分类。",
"text": {
"format": {
"type": "json_schema",
"name": "deployment_risk",
"strict": true,
"schema": {
"type": "object",
"properties": {
"risk": { "type": "string", "enum": ["low", "medium", "high"] },
"reason": { "type": "string" }
},
"required": ["risk", "reason"],
"additionalProperties": false
}
}
}
}'
```
## 请求体
固定为 `gpt-6-astra`。
提示词和可选上下文。
使用 `json_schema` 或 `text`。
Schema 名称。
预期输出说明。
定义响应结构的 JSON Schema。
是否严格遵守 Schema。
## 响应
```json 200 theme={null}
{
"id": "resp_01structuredexample",
"object": "response",
"model": "gpt-6-astra",
"status": "completed",
"output": [{
"id": "msg_01structuredexample",
"type": "message",
"status": "completed",
"role": "assistant",
"content": [{
"type": "output_text",
"text": "{\"risk\":\"medium\",\"reason\":\"重试操作不具备幂等性。\"}",
"annotations": []
}]
}]
}
```
符合所提供 Schema 的 JSON 文本。
## 创建响应
`POST /v1/responses`
```bash cURL theme={null}
curl --request POST \
--url https://www.anyfast.ai/v1/responses \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-6-astra",
"input": "检查服务 api-gateway 的部署状态。",
"tools": [{
"type": "function",
"name": "get_deployment_status",
"description": "返回指定服务当前的部署状态。",
"parameters": {
"type": "object",
"properties": { "service": { "type": "string" } },
"required": ["service"],
"additionalProperties": false
},
"strict": true,
"async": true
}],
"tool_choice": "auto",
"parallel_tool_calls": true,
"max_tool_calls": 4
}'
```
## 请求体
固定为 `gpt-6-astra`。工具调用必须使用 Responses API。
Function、Custom Tool 或受支持的内置工具定义。
`function`、`custom`、`web_search`、`code_interpreter`、`shell`、`apply_patch`、`computer` 或 `mcp`。
Function 或 Custom Tool 名称。
工具用途和调用条件。
Function 参数的 JSON Schema。
是否严格校验 Function 参数。
应用执行 Function 或 Custom Tool 时，是否允许模型继续处理独立工作。
直接模型工具调用使用 `direct`。
Function 输出的可选 JSON Schema。
网页搜索上下文大小，例如 `low`。
网页搜索允许访问的域名。
代码解释器容器配置。使用 `{ "type": "auto" }`；支持 `memory_limit`。
Shell 环境配置。使用 `{ "type": "container_auto" }`；支持 `memory_limit`。
MCP 服务器标签。
MCP 服务器 HTTPS 地址。
MCP 审批策略，例如 `never`。
`none`、`auto` 或指定工具的对象。
是否允许一个轮次中发起多个工具调用。
内置工具调用总数上限。
需要返回的工具详情，例如 `web_search_call.action.sources` 或 `code_interpreter_call.outputs`。
Function 和 Custom Tool 需要由你的应用实际执行。文件搜索要求 Vector Store 与请求位于同一上游资源，但 AnyFast 当前不提供 Vector Stores 管理端点。
## 工具调用响应
```json 200 theme={null}
{
"id": "resp_01toolexample",
"object": "response",
"model": "gpt-6-astra",
"status": "completed",
"output": [{
"id": "fc_01deployment",
"type": "function_call",
"call_id": "call_01deployment",
"name": "get_deployment_status",
"arguments": "{\"service\":\"api-gateway\"}",
"status": "completed",
"async": true
}]
}
```
此工作流中为 `function_call`。
工具调用关联 ID。
Function 名称。
JSON 编码的参数。
调用是否可以异步完成。
请勿依赖跨请求的响应或工具项引用。请求被路由到不同上游资源时，这类引用可能被拒绝。
## 创建文本补全
`POST /v1/chat/completions`
```bash cURL theme={null}
curl --request POST \
--url https://www.anyfast.ai/v1/chat/completions \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"model": "gpt-6-astra",
"messages": [{ "role": "user", "content": "返回一份简洁的部署检查清单。" }],
"reasoning_effort": "low",
"max_completion_tokens": 1024
}'
```
## 请求体
固定为 `gpt-6-astra`。
有序的 Chat Completions 消息。
消息角色。
文本消息内容。
`low`、`medium`、`high`、`xhigh` 或 `max`。
补全和推理 Token 总上限。
Chat Completions 仅用于文本请求。GPT-6 Astra 工具调用必须使用 Responses API。不要传入 `temperature`、`top_p`、`top_logprobs` 或 `logprobs`。
## 响应
Chat Completion ID。
生成的文本。
生成停止原因。
提示词、补全和总 Token 用量。
## 常见错误