API 参考
使用同一个网关和 API 密钥接入兼容 OpenAI、Anthropic、Gemini 与异步媒体的工作流。
- 服务器
https://api.anyint.ai提供此 OpenAPI 文档的 AnyInt Gateway 地址。
80 个端点
ChatRoom 集成
4 个端点为独立 ChatRoom 客户端查询当前密钥可用的模型与企业功能。
请求示例
curl \
--request POST \
--url 'https://api.anyint.ai/v1/tasks/request-costs' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"request_ids": [
"req_example:async"
]
}'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
请求体
必填{
"request_ids": [
"req_example:async"
]
}响应
{
"request_costs": [
{
"request_id": "req_example:async",
"credits": 125
}
]
}使用开发者 API 密钥认证的原生 ChatRoom 元数据。保留现有的租户/密钥可见性及已导入的稳定素材所有权引用。
GET /v1/chatroom/models请求示例
curl \
--request GET \
--url 'https://api.anyint.ai/v1/chatroom/models?scope=<scope>' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| scope | query | string | 必填 | — |
| limit | query | integer | 可选 | —示例: 1000 |
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
响应
{
"success": true,
"data": {
"models": [],
"total": 0
}
}使用开发者 API 密钥认证的原生 ChatRoom 元数据。保留现有的租户/密钥可见性及已导入的稳定素材所有权引用。
GET /v1/chatroom/enterprise-context请求示例
curl \
--request GET \
--url 'https://api.anyint.ai/v1/chatroom/enterprise-context' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
响应
{
"success": true,
"data": {
"featureControls": {
"seedanceAuthorizedAssets": false,
"videoDramaUsage": {
"enabled": false,
"dramaNames": []
}
}
}
}使用开发者 API 密钥认证的原生 ChatRoom 元数据。保留现有的租户/密钥可见性及已导入的稳定素材所有权引用。
GET /v1/chatroom/key-context请求示例
curl \
--request GET \
--url 'https://api.anyint.ai/v1/chatroom/key-context' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
响应
{
"success": true,
"data": {
"userId": "user_example",
"apiKeyId": "key_example",
"featureControls": {
"seedanceAuthorizedAssets": false,
"videoDramaUsage": {
"enabled": false,
"dramaNames": []
}
}
}
}对话
2 个端点创建兼容 OpenAI 的对话响应。
经 Gemini 适配器路由时,usage 包含 gemini_usage_metadata,保留原始 token 计数,用于精确的模态与缓存计费。OpenAI 输出总量包含 Gemini 思考 token;详细的原生计数保留在 Chat Completions、其 SSE 用量帧以及受支持的 Responses 转换中。嵌入式 Portkey Anthropic Chat 及定向 Responses 到 Anthropic 的转换在 JSON 和 SSE 中提供包含缓存的 OpenAI 输入总量,以及 anthropic_usage_metadata,其中保留原始普通输入、缓存读取、缓存写入及 5 分钟/1 小时缓存写入计数,以便精确计费。 原生请求保留提供方参数,但须符合所选模型的官方支持。跨协议请求通过请求中间表示(IR)映射受支持的内容和控制。未映射的扩展和近似控制记录在转换诊断中,而不会拒绝其他可用的请求。畸形的源内容仍返回 HTTP 400。无法表示的跨协议工具声明会在资金准入前返回 HTTP 400,而不会被静默丢弃;符合条件的原生路由可保留原生专属工具。Anthropic stop_sequences 映射到 Chat 的 stop;不会伪造上游未报告的匹配序列。使用 Responses previous_response_id/conversation、Anthropic thread 或 Gemini cachedContent 的请求需要其服务端状态。即使输入包含重复的历史记录,这些引用也绝不会被丢弃。路由会排除无法保留状态的转换,并优先选择符合条件的原生路由;状态归属仍取决于原始服务商/账户以及现有的连续性亲和性检查。如果所有候选均因此原因被排除,则在服务商派发前返回 HTTP 422 conversation_state_unavailable。网关当前不会物化引用的历史。仅原生协议可用性并不能证明所选账户中存在私有状态 ID。回退不会自动将 json_schema 降级为 json_object。 原生 Responses 接受 stream:null 作为非流式,并在原生请求体中保留 null。无效的非布尔值、非 null stream 值在出资或派发前返回 HTTP 400。原生 Responses 保留自定义工具调用、多部分工具输出、assistant phase 和 Unicode 文本。缺失/为 null 的 output_text annotations 和 logprobs 在出资和派发前变为空数组;提供方保活消息从历史中排除。reasoning.effort 按原样转发而不降级:结构化的不支持值拒绝返回 HTTP 400 invalid_value,附带 error.param=reasoning.effort 和服务端自有消息。提供方生成或无法定位的 400 变为 HTTP 502 upstream_error;瞬态被拒绝的工作可重试,除非执行结果未确认。定向 Responses 转换针对 response.created 和终止事件保留同一个 created_at。Responses 到 Chat 在出资前验证实际目标转换,包括不支持的历史/状态输入。流式过滤 response.metadata、codex.response.metadata、responsesapi.websocket_timing 和 SSE-Keep-Alive 控制项,使用 SSE 注释作为心跳,并发出单调递增的 sequence_number 值。心跳名称不区分大小写,接受 keepalive、keep-alive 和 keep_alive 变体;它们成为 SSE 注释,不终止有效输出或更改用量。重复的 SSE 事件字段采用最后一个字段值,包括空重置。显式 error/response.failed SSE 事件头及错误载荷(包含嵌套的 response.error 或 response.status=failed)优先于心跳、诊断元数据和保活项标记。失败事件名称及失败类型标记不区分大小写识别,不重写成功的生命周期类型。它们发出一个脱敏的 response.failed,并抑制后续成功完成,同时保留原始字节以供结算。成功的终止事件仅在强制流结算成功后交付:成功为 response.completed,提供方 token 限制为 response.incomplete。强制结算失败发出 response.failed,保留已发送的 HTTP 状态,并记录失败的最终推理结果。提前 EOF、超时或提供方失败以 response.failed 结束,绝不合成成功完成或旧版 [DONE]。流故障不可重试,因为重放可能重复已派发的工作。可选的 x-client-message-id/x-resume-message-id 请求头启用现有的事件偏移恢复扩展;未携带这些请求头的客户端无需此项。
POST /v1/chat/completions请求示例
curl \
--request POST \
--url 'https://api.anyint.ai/v1/chat/completions' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"model": "your-model-id",
"messages": [
{
"role": "user",
"content": "Explain edge computing in 2 sentences."
}
]
}'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| X-Client-Message-Id | header | string | 可选 | 启用租户范围的持久执行去重。只能使用相同请求体和 API 密钥重用消息 ID。已完成或可能已经派发的请求不会因到期或 Redis 数据丢失而再次执行。派发后即使上游报错或结算回滚,也须使用新消息 ID 发起另一次执行;派发前失败可使用原 ID 重试。 |
| X-Resume-Message-Id | header | string | 可选 | 使用原 API 密钥和相同请求体重放已生成的 SSE 流,不会再次调用上游或计费。缓存保留 10 分钟,输出总量上限为 4 MiB;中断后的续写须使用新的消息 ID。 |
| X-Resume-From-Offset | header | integer | 可选 | 已接收的完整 SSE 事件数,与最后一个 SSE id 一致,从 0 开始;单位不是 UTF-8 字节、令牌或字符。优先于 Last-Event-ID。 |
| Last-Event-ID | header | integer | 可选 | 未提供 X-Resume-From-Offset 时使用的完整 SSE 事件偏移量。 |
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
请求体
必填{
"model": "your-model-id",
"messages": [
{
"role": "user",
"content": "Explain edge computing in 2 sentences."
}
]
}响应
{
"id": "chatcmpl_example",
"object": "chat.completion",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "Edge computing processes data near its source, reducing latency and bandwidth use."
},
"finish_reason": "stop"
}
]
}经 Gemini 适配器路由时,usage 包含 gemini_usage_metadata,保留原始 token 计数,用于精确的模态与缓存计费。OpenAI 输出总量包含 Gemini 思考 token;详细的原生计数保留在 Chat Completions、其 SSE 用量帧以及受支持的 Responses 转换中。嵌入式 Portkey Anthropic Chat 及定向 Responses 到 Anthropic 的转换在 JSON 和 SSE 中提供包含缓存的 OpenAI 输入总量,以及 anthropic_usage_metadata,其中保留原始普通输入、缓存读取、缓存写入及 5 分钟/1 小时缓存写入计数,以便精确计费。 原生请求保留提供方参数,但须符合所选模型的官方支持。跨协议请求通过请求中间表示(IR)映射受支持的内容和控制。未映射的扩展和近似控制记录在转换诊断中,而不会拒绝其他可用的请求。畸形的源内容仍返回 HTTP 400。无法表示的跨协议工具声明会在资金准入前返回 HTTP 400,而不会被静默丢弃;符合条件的原生路由可保留原生专属工具。Anthropic stop_sequences 映射到 Chat 的 stop;不会伪造上游未报告的匹配序列。使用 Responses previous_response_id/conversation、Anthropic thread 或 Gemini cachedContent 的请求需要其服务端状态。即使输入包含重复的历史记录,这些引用也绝不会被丢弃。路由会排除无法保留状态的转换,并优先选择符合条件的原生路由;状态归属仍取决于原始服务商/账户以及现有的连续性亲和性检查。如果所有候选均因此原因被排除,则在服务商派发前返回 HTTP 422 conversation_state_unavailable。网关当前不会物化引用的历史。仅原生协议可用性并不能证明所选账户中存在私有状态 ID。回退不会自动将 json_schema 降级为 json_object。 原生 Responses 接受 stream:null 作为非流式,并在原生请求体中保留 null。无效的非布尔值、非 null stream 值在出资或派发前返回 HTTP 400。原生 Responses 保留自定义工具调用、多部分工具输出、assistant phase 和 Unicode 文本。缺失/为 null 的 output_text annotations 和 logprobs 在出资和派发前变为空数组;提供方保活消息从历史中排除。reasoning.effort 按原样转发而不降级:结构化的不支持值拒绝返回 HTTP 400 invalid_value,附带 error.param=reasoning.effort 和服务端自有消息。提供方生成或无法定位的 400 变为 HTTP 502 upstream_error;瞬态被拒绝的工作可重试,除非执行结果未确认。定向 Responses 转换针对 response.created 和终止事件保留同一个 created_at。Responses 到 Chat 在出资前验证实际目标转换,包括不支持的历史/状态输入。流式过滤 response.metadata、codex.response.metadata、responsesapi.websocket_timing 和 SSE-Keep-Alive 控制项,使用 SSE 注释作为心跳,并发出单调递增的 sequence_number 值。心跳名称不区分大小写,接受 keepalive、keep-alive 和 keep_alive 变体;它们成为 SSE 注释,不终止有效输出或更改用量。重复的 SSE 事件字段采用最后一个字段值,包括空重置。显式 error/response.failed SSE 事件头及错误载荷(包含嵌套的 response.error 或 response.status=failed)优先于心跳、诊断元数据和保活项标记。失败事件名称及失败类型标记不区分大小写识别,不重写成功的生命周期类型。它们发出一个脱敏的 response.failed,并抑制后续成功完成,同时保留原始字节以供结算。成功的终止事件仅在强制流结算成功后交付:成功为 response.completed,提供方 token 限制为 response.incomplete。强制结算失败发出 response.failed,保留已发送的 HTTP 状态,并记录失败的最终推理结果。提前 EOF、超时或提供方失败以 response.failed 结束,绝不合成成功完成或旧版 [DONE]。流故障不可重试,因为重放可能重复已派发的工作。可选的 x-client-message-id/x-resume-message-id 请求头启用现有的事件偏移恢复扩展;未携带这些请求头的客户端无需此项。
POST /openai/v1/chat/completions请求示例
curl \
--request POST \
--url 'https://api.anyint.ai/openai/v1/chat/completions' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"model": "your-model-id",
"messages": [
{
"role": "user",
"content": "Explain edge computing in 2 sentences."
}
]
}'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| X-Client-Message-Id | header | string | 可选 | 启用租户范围的持久执行去重。只能使用相同请求体和 API 密钥重用消息 ID。已完成或可能已经派发的请求不会因到期或 Redis 数据丢失而再次执行。派发后即使上游报错或结算回滚,也须使用新消息 ID 发起另一次执行;派发前失败可使用原 ID 重试。 |
| X-Resume-Message-Id | header | string | 可选 | 使用原 API 密钥和相同请求体重放已生成的 SSE 流,不会再次调用上游或计费。缓存保留 10 分钟,输出总量上限为 4 MiB;中断后的续写须使用新的消息 ID。 |
| X-Resume-From-Offset | header | integer | 可选 | 已接收的完整 SSE 事件数,与最后一个 SSE id 一致,从 0 开始;单位不是 UTF-8 字节、令牌或字符。优先于 Last-Event-ID。 |
| Last-Event-ID | header | integer | 可选 | 未提供 X-Resume-From-Offset 时使用的完整 SSE 事件偏移量。 |
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
请求体
必填{
"model": "your-model-id",
"messages": [
{
"role": "user",
"content": "Explain edge computing in 2 sentences."
}
]
}响应
{
"id": "chatcmpl_example",
"object": "chat.completion",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "Edge computing processes data near its source, reducing latency and bandwidth use."
},
"finish_reason": "stop"
}
]
}响应
2 个端点使用 OpenAI Responses API 结构创建响应。
经 Gemini 适配器路由时,usage 包含 gemini_usage_metadata,保留原始 token 计数,用于精确的模态与缓存计费。OpenAI 输出总量包含 Gemini 思考 token;详细的原生计数保留在 Chat Completions、其 SSE 用量帧以及受支持的 Responses 转换中。嵌入式 Portkey Anthropic Chat 及定向 Responses 到 Anthropic 的转换在 JSON 和 SSE 中提供包含缓存的 OpenAI 输入总量,以及 anthropic_usage_metadata,其中保留原始普通输入、缓存读取、缓存写入及 5 分钟/1 小时缓存写入计数,以便精确计费。 原生请求保留提供方参数,但须符合所选模型的官方支持。跨协议请求通过请求中间表示(IR)映射受支持的内容和控制。未映射的扩展和近似控制记录在转换诊断中,而不会拒绝其他可用的请求。畸形的源内容仍返回 HTTP 400。无法表示的跨协议工具声明会在资金准入前返回 HTTP 400,而不会被静默丢弃;符合条件的原生路由可保留原生专属工具。Anthropic stop_sequences 映射到 Chat 的 stop;不会伪造上游未报告的匹配序列。使用 Responses previous_response_id/conversation、Anthropic thread 或 Gemini cachedContent 的请求需要其服务端状态。即使输入包含重复的历史记录,这些引用也绝不会被丢弃。路由会排除无法保留状态的转换,并优先选择符合条件的原生路由;状态归属仍取决于原始服务商/账户以及现有的连续性亲和性检查。如果所有候选均因此原因被排除,则在服务商派发前返回 HTTP 422 conversation_state_unavailable。网关当前不会物化引用的历史。仅原生协议可用性并不能证明所选账户中存在私有状态 ID。回退不会自动将 json_schema 降级为 json_object。 原生 Responses 接受 stream:null 作为非流式,并在原生请求体中保留 null。无效的非布尔值、非 null stream 值在出资或派发前返回 HTTP 400。原生 Responses 保留自定义工具调用、多部分工具输出、assistant phase 和 Unicode 文本。缺失/为 null 的 output_text annotations 和 logprobs 在出资和派发前变为空数组;提供方保活消息从历史中排除。reasoning.effort 按原样转发而不降级:结构化的不支持值拒绝返回 HTTP 400 invalid_value,附带 error.param=reasoning.effort 和服务端自有消息。提供方生成或无法定位的 400 变为 HTTP 502 upstream_error;瞬态被拒绝的工作可重试,除非执行结果未确认。定向 Responses 转换针对 response.created 和终止事件保留同一个 created_at。Responses 到 Chat 在出资前验证实际目标转换,包括不支持的历史/状态输入。流式过滤 response.metadata、codex.response.metadata、responsesapi.websocket_timing 和 SSE-Keep-Alive 控制项,使用 SSE 注释作为心跳,并发出单调递增的 sequence_number 值。心跳名称不区分大小写,接受 keepalive、keep-alive 和 keep_alive 变体;它们成为 SSE 注释,不终止有效输出或更改用量。重复的 SSE 事件字段采用最后一个字段值,包括空重置。显式 error/response.failed SSE 事件头及错误载荷(包含嵌套的 response.error 或 response.status=failed)优先于心跳、诊断元数据和保活项标记。失败事件名称及失败类型标记不区分大小写识别,不重写成功的生命周期类型。它们发出一个脱敏的 response.failed,并抑制后续成功完成,同时保留原始字节以供结算。成功的终止事件仅在强制流结算成功后交付:成功为 response.completed,提供方 token 限制为 response.incomplete。强制结算失败发出 response.failed,保留已发送的 HTTP 状态,并记录失败的最终推理结果。提前 EOF、超时或提供方失败以 response.failed 结束,绝不合成成功完成或旧版 [DONE]。流故障不可重试,因为重放可能重复已派发的工作。可选的 x-client-message-id/x-resume-message-id 请求头启用现有的事件偏移恢复扩展;未携带这些请求头的客户端无需此项。
POST /v1/responses请求示例
curl \
--request POST \
--url 'https://api.anyint.ai/v1/responses' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"model": "your-model-id",
"input": "Write a short welcome message."
}'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| X-Client-Message-Id | header | string | 可选 | 启用租户范围的持久执行去重。只能使用相同请求体和 API 密钥重用消息 ID。已完成或可能已经派发的请求不会因到期或 Redis 数据丢失而再次执行。派发后即使上游报错或结算回滚,也须使用新消息 ID 发起另一次执行;派发前失败可使用原 ID 重试。 |
| X-Resume-Message-Id | header | string | 可选 | 使用原 API 密钥和相同请求体重放已生成的 SSE 流,不会再次调用上游或计费。缓存保留 10 分钟,输出总量上限为 4 MiB;中断后的续写须使用新的消息 ID。 |
| X-Resume-From-Offset | header | integer | 可选 | 已接收的完整 SSE 事件数,与最后一个 SSE id 一致,从 0 开始;单位不是 UTF-8 字节、令牌或字符。优先于 Last-Event-ID。 |
| Last-Event-ID | header | integer | 可选 | 未提供 X-Resume-From-Offset 时使用的完整 SSE 事件偏移量。 |
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
请求体
必填{
"model": "your-model-id",
"input": "Write a short welcome message."
}响应
{
"id": "resp_example",
"object": "response",
"status": "completed"
}经 Gemini 适配器路由时,usage 包含 gemini_usage_metadata,保留原始 token 计数,用于精确的模态与缓存计费。OpenAI 输出总量包含 Gemini 思考 token;详细的原生计数保留在 Chat Completions、其 SSE 用量帧以及受支持的 Responses 转换中。嵌入式 Portkey Anthropic Chat 及定向 Responses 到 Anthropic 的转换在 JSON 和 SSE 中提供包含缓存的 OpenAI 输入总量,以及 anthropic_usage_metadata,其中保留原始普通输入、缓存读取、缓存写入及 5 分钟/1 小时缓存写入计数,以便精确计费。 原生请求保留提供方参数,但须符合所选模型的官方支持。跨协议请求通过请求中间表示(IR)映射受支持的内容和控制。未映射的扩展和近似控制记录在转换诊断中,而不会拒绝其他可用的请求。畸形的源内容仍返回 HTTP 400。无法表示的跨协议工具声明会在资金准入前返回 HTTP 400,而不会被静默丢弃;符合条件的原生路由可保留原生专属工具。Anthropic stop_sequences 映射到 Chat 的 stop;不会伪造上游未报告的匹配序列。使用 Responses previous_response_id/conversation、Anthropic thread 或 Gemini cachedContent 的请求需要其服务端状态。即使输入包含重复的历史记录,这些引用也绝不会被丢弃。路由会排除无法保留状态的转换,并优先选择符合条件的原生路由;状态归属仍取决于原始服务商/账户以及现有的连续性亲和性检查。如果所有候选均因此原因被排除,则在服务商派发前返回 HTTP 422 conversation_state_unavailable。网关当前不会物化引用的历史。仅原生协议可用性并不能证明所选账户中存在私有状态 ID。回退不会自动将 json_schema 降级为 json_object。 原生 Responses 接受 stream:null 作为非流式,并在原生请求体中保留 null。无效的非布尔值、非 null stream 值在出资或派发前返回 HTTP 400。原生 Responses 保留自定义工具调用、多部分工具输出、assistant phase 和 Unicode 文本。缺失/为 null 的 output_text annotations 和 logprobs 在出资和派发前变为空数组;提供方保活消息从历史中排除。reasoning.effort 按原样转发而不降级:结构化的不支持值拒绝返回 HTTP 400 invalid_value,附带 error.param=reasoning.effort 和服务端自有消息。提供方生成或无法定位的 400 变为 HTTP 502 upstream_error;瞬态被拒绝的工作可重试,除非执行结果未确认。定向 Responses 转换针对 response.created 和终止事件保留同一个 created_at。Responses 到 Chat 在出资前验证实际目标转换,包括不支持的历史/状态输入。流式过滤 response.metadata、codex.response.metadata、responsesapi.websocket_timing 和 SSE-Keep-Alive 控制项,使用 SSE 注释作为心跳,并发出单调递增的 sequence_number 值。心跳名称不区分大小写,接受 keepalive、keep-alive 和 keep_alive 变体;它们成为 SSE 注释,不终止有效输出或更改用量。重复的 SSE 事件字段采用最后一个字段值,包括空重置。显式 error/response.failed SSE 事件头及错误载荷(包含嵌套的 response.error 或 response.status=failed)优先于心跳、诊断元数据和保活项标记。失败事件名称及失败类型标记不区分大小写识别,不重写成功的生命周期类型。它们发出一个脱敏的 response.failed,并抑制后续成功完成,同时保留原始字节以供结算。成功的终止事件仅在强制流结算成功后交付:成功为 response.completed,提供方 token 限制为 response.incomplete。强制结算失败发出 response.failed,保留已发送的 HTTP 状态,并记录失败的最终推理结果。提前 EOF、超时或提供方失败以 response.failed 结束,绝不合成成功完成或旧版 [DONE]。流故障不可重试,因为重放可能重复已派发的工作。可选的 x-client-message-id/x-resume-message-id 请求头启用现有的事件偏移恢复扩展;未携带这些请求头的客户端无需此项。
POST /openai/v1/responses请求示例
curl \
--request POST \
--url 'https://api.anyint.ai/openai/v1/responses' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"model": "your-model-id",
"input": "Write a short welcome message."
}'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| X-Client-Message-Id | header | string | 可选 | 启用租户范围的持久执行去重。只能使用相同请求体和 API 密钥重用消息 ID。已完成或可能已经派发的请求不会因到期或 Redis 数据丢失而再次执行。派发后即使上游报错或结算回滚,也须使用新消息 ID 发起另一次执行;派发前失败可使用原 ID 重试。 |
| X-Resume-Message-Id | header | string | 可选 | 使用原 API 密钥和相同请求体重放已生成的 SSE 流,不会再次调用上游或计费。缓存保留 10 分钟,输出总量上限为 4 MiB;中断后的续写须使用新的消息 ID。 |
| X-Resume-From-Offset | header | integer | 可选 | 已接收的完整 SSE 事件数,与最后一个 SSE id 一致,从 0 开始;单位不是 UTF-8 字节、令牌或字符。优先于 Last-Event-ID。 |
| Last-Event-ID | header | integer | 可选 | 未提供 X-Resume-From-Offset 时使用的完整 SSE 事件偏移量。 |
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
请求体
必填{
"model": "your-model-id",
"input": "Write a short welcome message."
}响应
{
"id": "resp_example",
"object": "response",
"status": "completed"
}文本补全
2 个端点创建兼容 OpenAI 的传统文本补全。
OpenAI 传统 Completions 支持布尔值或 null 的 stream 参数。null 表示非流式,并在原生服务商请求中保持 null;其他非布尔值会在资金准入或服务商外发前返回 HTTP 400。
POST /v1/completions请求示例
curl \
--request POST \
--url 'https://api.anyint.ai/v1/completions' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"model": "your-model-id",
"prompt": "Once upon a time"
}'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| X-Client-Message-Id | header | string | 可选 | 启用租户范围的持久执行去重。只能使用相同请求体和 API 密钥重用消息 ID。已完成或可能已经派发的请求不会因到期或 Redis 数据丢失而再次执行。派发后即使上游报错或结算回滚,也须使用新消息 ID 发起另一次执行;派发前失败可使用原 ID 重试。 |
| X-Resume-Message-Id | header | string | 可选 | 使用原 API 密钥和相同请求体重放已生成的 SSE 流,不会再次调用上游或计费。缓存保留 10 分钟,输出总量上限为 4 MiB;中断后的续写须使用新的消息 ID。 |
| X-Resume-From-Offset | header | integer | 可选 | 已接收的完整 SSE 事件数,与最后一个 SSE id 一致,从 0 开始;单位不是 UTF-8 字节、令牌或字符。优先于 Last-Event-ID。 |
| Last-Event-ID | header | integer | 可选 | 未提供 X-Resume-From-Offset 时使用的完整 SSE 事件偏移量。 |
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
请求体
必填{
"model": "your-model-id",
"prompt": "Once upon a time"
}响应
{
"id": "cmpl_example",
"object": "text_completion",
"choices": [
{
"index": 0,
"text": " there was a quiet coast."
}
]
}OpenAI 传统 Completions 支持布尔值或 null 的 stream 参数。null 表示非流式,并在原生服务商请求中保持 null;其他非布尔值会在资金准入或服务商外发前返回 HTTP 400。
POST /openai/v1/completions请求示例
curl \
--request POST \
--url 'https://api.anyint.ai/openai/v1/completions' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"model": "your-model-id",
"prompt": "Once upon a time"
}'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| X-Client-Message-Id | header | string | 可选 | 启用租户范围的持久执行去重。只能使用相同请求体和 API 密钥重用消息 ID。已完成或可能已经派发的请求不会因到期或 Redis 数据丢失而再次执行。派发后即使上游报错或结算回滚,也须使用新消息 ID 发起另一次执行;派发前失败可使用原 ID 重试。 |
| X-Resume-Message-Id | header | string | 可选 | 使用原 API 密钥和相同请求体重放已生成的 SSE 流,不会再次调用上游或计费。缓存保留 10 分钟,输出总量上限为 4 MiB;中断后的续写须使用新的消息 ID。 |
| X-Resume-From-Offset | header | integer | 可选 | 已接收的完整 SSE 事件数,与最后一个 SSE id 一致,从 0 开始;单位不是 UTF-8 字节、令牌或字符。优先于 Last-Event-ID。 |
| Last-Event-ID | header | integer | 可选 | 未提供 X-Resume-From-Offset 时使用的完整 SSE 事件偏移量。 |
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
请求体
必填{
"model": "your-model-id",
"prompt": "Once upon a time"
}响应
{
"id": "cmpl_example",
"object": "text_completion",
"choices": [
{
"index": 0,
"text": " there was a quiet coast."
}
]
}嵌入
2 个端点从文本输入创建向量嵌入。
请求示例
curl \
--request POST \
--url 'https://api.anyint.ai/v1/embeddings' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"model": "your-model-id",
"input": "A calm ocean at dawn"
}'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
请求体
必填{
"model": "your-model-id",
"input": "A calm ocean at dawn"
}响应
{
"object": "list",
"data": [
{
"object": "embedding",
"index": 0,
"embedding": [
0.012,
-0.008,
0.021
]
}
]
}请求示例
curl \
--request POST \
--url 'https://api.anyint.ai/openai/v1/embeddings' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"model": "your-model-id",
"input": "A calm ocean at dawn"
}'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
请求体
必填{
"model": "your-model-id",
"input": "A calm ocean at dawn"
}响应
{
"object": "list",
"data": [
{
"object": "embedding",
"index": 0,
"embedding": [
0.012,
-0.008,
0.021
]
}
]
}内容审核
2 个端点识别可能有害的文本或图像输入。
请求示例
curl \
--request POST \
--url 'https://api.anyint.ai/v1/moderations' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"input": "Text to classify"
}'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
请求体
必填{
"input": "Text to classify"
}响应
{
"id": "modr_example",
"model": "your-model-id",
"results": [
{
"flagged": false,
"categories": {},
"category_scores": {}
}
]
}请求示例
curl \
--request POST \
--url 'https://api.anyint.ai/openai/v1/moderations' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"input": "Text to classify"
}'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
请求体
必填{
"input": "Text to classify"
}响应
{
"id": "modr_example",
"model": "your-model-id",
"results": [
{
"flagged": false,
"categories": {},
"category_scores": {}
}
]
}批处理
8 个端点在当前部署启用对象存储后,提交供应商原生 JSONL 批处理任务。
请求示例
curl \
--request GET \
--url 'https://api.anyint.ai/v1/batches' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| after | query | string | 可选 | — |
| limit | query | integer | 可选 | —示例: 20 |
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
响应
{
"object": "list",
"data": [
{
"id": "batch_example",
"object": "batch",
"endpoint": "/v1/chat/completions",
"input_file_id": "file_example",
"completion_window": "24h",
"status": "in_progress",
"created_at": 1700000000,
"request_counts": {
"total": 100,
"completed": 0,
"failed": 0
}
}
],
"first_id": "batch_example",
"last_id": "batch_example",
"has_more": false
}原生预付批量请求在资金准入前验证已存文件哈希和严格 JSONL。每个项目均须有绑定路由和价格的服务端执行策略,包含文件上传与批量创建的外发约束。所有项目的冻结须在提交提供方前原子完成;整批资金不足返回 HTTP 402,不提交部分批次。提供方配置不同的项目须拆分为独立批次。每次提交最多上传一次文件和创建一次批次;结果未知返回 batch_submission_recovery_required,保留冻结且不自动重新提交。失败、取消或缺失的项目结果不能证明提供方费用为零,资金保留待核实。
POST /v1/batches请求示例
curl \
--request POST \
--url 'https://api.anyint.ai/v1/batches' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"input_file_id": "file_example",
"endpoint": "/v1/chat/completions",
"completion_window": "24h"
}'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。请求体
必填{
"input_file_id": "file_example",
"endpoint": "/v1/chat/completions",
"completion_window": "24h"
}响应
{
"id": "batch_example",
"object": "batch",
"endpoint": "/v1/chat/completions",
"input_file_id": "file_example",
"completion_window": "24h",
"status": "in_progress",
"created_at": 1700000000,
"request_counts": {
"total": 100,
"completed": 0,
"failed": 0
}
}请求示例
curl \
--request GET \
--url 'https://api.anyint.ai/openai/v1/batches' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| after | query | string | 可选 | — |
| limit | query | integer | 可选 | —示例: 20 |
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
响应
{
"object": "list",
"data": [
{
"id": "batch_example",
"object": "batch",
"endpoint": "/v1/chat/completions",
"input_file_id": "file_example",
"completion_window": "24h",
"status": "in_progress",
"created_at": 1700000000,
"request_counts": {
"total": 100,
"completed": 0,
"failed": 0
}
}
],
"first_id": "batch_example",
"last_id": "batch_example",
"has_more": false
}原生预付批量请求在资金准入前验证已存文件哈希和严格 JSONL。每个项目均须有绑定路由和价格的服务端执行策略,包含文件上传与批量创建的外发约束。所有项目的冻结须在提交提供方前原子完成;整批资金不足返回 HTTP 402,不提交部分批次。提供方配置不同的项目须拆分为独立批次。每次提交最多上传一次文件和创建一次批次;结果未知返回 batch_submission_recovery_required,保留冻结且不自动重新提交。失败、取消或缺失的项目结果不能证明提供方费用为零,资金保留待核实。
POST /openai/v1/batches请求示例
curl \
--request POST \
--url 'https://api.anyint.ai/openai/v1/batches' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"input_file_id": "file_example",
"endpoint": "/v1/chat/completions",
"completion_window": "24h"
}'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。请求体
必填{
"input_file_id": "file_example",
"endpoint": "/v1/chat/completions",
"completion_window": "24h"
}响应
{
"id": "batch_example",
"object": "batch",
"endpoint": "/v1/chat/completions",
"input_file_id": "file_example",
"completion_window": "24h",
"status": "in_progress",
"created_at": 1700000000,
"request_counts": {
"total": 100,
"completed": 0,
"failed": 0
}
}请求示例
curl \
--request GET \
--url 'https://api.anyint.ai/v1/batches/<batch_id>' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| batch_id | path | string | 必填 | — |
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
响应
{
"id": "batch_example",
"object": "batch",
"endpoint": "/v1/chat/completions",
"input_file_id": "file_example",
"completion_window": "24h",
"status": "in_progress",
"created_at": 1700000000,
"request_counts": {
"total": 100,
"completed": 0,
"failed": 0
}
}请求示例
curl \
--request GET \
--url 'https://api.anyint.ai/openai/v1/batches/<batch_id>' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| batch_id | path | string | 必填 | — |
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
响应
{
"id": "batch_example",
"object": "batch",
"endpoint": "/v1/chat/completions",
"input_file_id": "file_example",
"completion_window": "24h",
"status": "in_progress",
"created_at": 1700000000,
"request_counts": {
"total": 100,
"completed": 0,
"failed": 0
}
}请求示例
curl \
--request POST \
--url 'https://api.anyint.ai/v1/batches/<batch_id>/cancel' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| batch_id | path | string | 必填 | — |
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
响应
{
"id": "batch_example",
"object": "batch",
"endpoint": "/v1/chat/completions",
"input_file_id": "file_example",
"completion_window": "24h",
"status": "in_progress",
"created_at": 1700000000,
"request_counts": {
"total": 100,
"completed": 0,
"failed": 0
}
}请求示例
curl \
--request POST \
--url 'https://api.anyint.ai/openai/v1/batches/<batch_id>/cancel' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| batch_id | path | string | 必填 | — |
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
响应
{
"id": "batch_example",
"object": "batch",
"endpoint": "/v1/chat/completions",
"input_file_id": "file_example",
"completion_window": "24h",
"status": "in_progress",
"created_at": 1700000000,
"request_counts": {
"total": 100,
"completed": 0,
"failed": 0
}
}文件
5 个端点上传、列出、查看和下载文件。
请求示例
curl \
--request GET \
--url 'https://api.anyint.ai/openai/v1/files' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
响应
{
"object": "list",
"data": [
{
"id": "file_example",
"object": "file",
"bytes": 128,
"created_at": 1700000000,
"filename": "document.jsonl",
"purpose": "batch",
"status": "processed"
}
]
}存储内容前执行 API 密钥的 IP 与每分钟请求数策略。上传与模型无关,不消耗推理配额。文件在上传 30 天后过期,除非通过 expires_after 设置更短的有效期(1 小时至 30 天);过期文件不再出现在列表中、无法下载,并会被清除。每个租户最多保留 10,000 个有效文件,总大小不超过 10 GiB。
POST /openai/v1/files请求示例
curl \
--request POST \
--url 'https://api.anyint.ai/openai/v1/files' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json' \
--form 'file=@path/to/document.jsonl' \
--form 'purpose=batch'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
请求体
必填{
"file": "document.jsonl",
"purpose": "batch"
}响应
{
"id": "file_example",
"object": "file",
"bytes": 128,
"created_at": 1700000000,
"filename": "document.jsonl",
"purpose": "batch",
"status": "processed"
}请求示例
curl \
--request GET \
--url 'https://api.anyint.ai/openai/v1/files/<file_id>' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| file_id | path | string | 必填 | — |
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
响应
{
"id": "file_example",
"object": "file",
"bytes": 128,
"created_at": 1700000000,
"filename": "document.jsonl",
"purpose": "batch",
"status": "processed"
}请求示例
curl \
--request DELETE \
--url 'https://api.anyint.ai/openai/v1/files/<file_id>' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| file_id | path | string | 必填 | — |
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
响应
{
"id": "file_example",
"object": "file",
"deleted": true
}请求示例
curl \
--request GET \
--url 'https://api.anyint.ai/openai/v1/files/<file_id>/content' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/octet-stream'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| file_id | path | string | 必填 | — |
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
响应
<binary>音频
3 个端点转写音频、将音频翻译为英语或合成语音。
原生预付组织在调用音频提供方前,冻结客户与提供方各自费用上界中较大的金额。缺失或不匹配的服务端执行上界返回不可自动重试的 HTTP 503 prepaid_execution_bound_unavailable。Multipart 上界包含文件大小与内容哈希。余额不足返回 HTTP 402。成功响应须包含计价规则要求的用量;缺失必要用量返回 HTTP 502 并保留冻结。提供方错误或结果未知时保留资金,待有依据的审计恢复处理。个人与后付音频行为保持现有口径。
POST /openai/v1/audio/transcriptions请求示例
curl \
--request POST \
--url 'https://api.anyint.ai/openai/v1/audio/transcriptions' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json' \
--form 'file=@path/to/audio.wav' \
--form 'model=your-model-id'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
请求体
必填{
"file": "audio.wav",
"model": "your-model-id"
}响应
{
"text": "Example transcript."
}原生预付组织在调用音频提供方前,冻结客户与提供方各自费用上界中较大的金额。缺失或不匹配的服务端执行上界返回不可自动重试的 HTTP 503 prepaid_execution_bound_unavailable。Multipart 上界包含文件大小与内容哈希。余额不足返回 HTTP 402。成功响应须包含计价规则要求的用量;缺失必要用量返回 HTTP 502 并保留冻结。提供方错误或结果未知时保留资金,待有依据的审计恢复处理。个人与后付音频行为保持现有口径。
POST /openai/v1/audio/translations请求示例
curl \
--request POST \
--url 'https://api.anyint.ai/openai/v1/audio/translations' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json' \
--form 'file=@path/to/audio.wav' \
--form 'model=your-model-id'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
请求体
必填{
"file": "audio.wav",
"model": "your-model-id"
}响应
{
"text": "Example transcript."
}原生预付组织在调用音频提供方前,冻结客户与提供方各自费用上界中较大的金额。缺失或不匹配的服务端执行上界返回不可自动重试的 HTTP 503 prepaid_execution_bound_unavailable。Multipart 上界包含文件大小与内容哈希。余额不足返回 HTTP 402。成功响应须包含计价规则要求的用量;缺失必要用量返回 HTTP 502 并保留冻结。提供方错误或结果未知时保留资金,待有依据的审计恢复处理。个人与后付音频行为保持现有口径。
POST /openai/v1/audio/speech请求示例
curl \
--request POST \
--url 'https://api.anyint.ai/openai/v1/audio/speech' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: audio/mpeg' \
--header 'Content-Type: application/json' \
--data '{
"model": "your-model-id",
"voice": "your-voice-id",
"input": "Welcome to AnyInt Gateway."
}'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
请求体
必填{
"model": "your-model-id",
"voice": "your-voice-id",
"input": "Welcome to AnyInt Gateway."
}响应
<binary>图像
4 个端点通过兼容 OpenAI 的请求生成和编辑图像。
支持 multipart 上传图片或非流式 JSON URL 输入。JSON 格式需要 model、prompt 以及 1-16 张带有 image_url 的图片;mask 可包含一个 image_url。URL 输入使用所选上游的原生 JSON Images API,因此该渠道必须支持 URL 编辑。模型权限、企业渠道选择、资金准入与结算同时适用于这两种输入。URL 必须使用公开的 HTTPS 且不得内嵌凭证;网关不会下载这些图片。其他原生 JSON 参数予以保留。gpt-image-2 默认 quality 为 medium。畸形的 URL 输入、图片缺失、不支持的流式请求、无效的图片数量以及无效的质量参数均会在资金准入或服务商外发前返回 HTTP 400。
POST /v1/images/edits请求示例
curl \
--request POST \
--url 'https://api.anyint.ai/v1/images/edits' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"model": "your-model-id",
"prompt": "Combine these reference images on a soft blue background.",
"images": [
{
"image_url": "https://cdn.example.com/reference-1.png"
},
{
"image_url": "https://cdn.example.com/reference-2.png"
}
]
}'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
请求体
必填{
"model": "your-model-id",
"prompt": "Combine these reference images on a soft blue background.",
"images": [
{
"image_url": "https://cdn.example.com/reference-1.png"
},
{
"image_url": "https://cdn.example.com/reference-2.png"
}
]
}响应
{
"created": 1700000000,
"data": [
{
"b64_json": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAAB"
}
]
}支持 multipart 上传图片或非流式 JSON URL 输入。JSON 格式需要 model、prompt 以及 1-16 张带有 image_url 的图片;mask 可包含一个 image_url。URL 输入使用所选上游的原生 JSON Images API,因此该渠道必须支持 URL 编辑。模型权限、企业渠道选择、资金准入与结算同时适用于这两种输入。URL 必须使用公开的 HTTPS 且不得内嵌凭证;网关不会下载这些图片。其他原生 JSON 参数予以保留。gpt-image-2 默认 quality 为 medium。畸形的 URL 输入、图片缺失、不支持的流式请求、无效的图片数量以及无效的质量参数均会在资金准入或服务商外发前返回 HTTP 400。
POST /openai/v1/images/edits请求示例
curl \
--request POST \
--url 'https://api.anyint.ai/openai/v1/images/edits' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"model": "your-model-id",
"prompt": "Combine these reference images on a soft blue background.",
"images": [
{
"image_url": "https://cdn.example.com/reference-1.png"
},
{
"image_url": "https://cdn.example.com/reference-2.png"
}
]
}'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
请求体
必填{
"model": "your-model-id",
"prompt": "Combine these reference images on a soft blue background.",
"images": [
{
"image_url": "https://cdn.example.com/reference-1.png"
},
{
"image_url": "https://cdn.example.com/reference-2.png"
}
]
}响应
{
"created": 1700000000,
"data": [
{
"b64_json": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAAB"
}
]
}支持 multipart 上传图片或非流式 JSON URL 输入。JSON 格式需要 model、prompt 以及 1-16 张带有 image_url 的图片;mask 可包含一个 image_url。URL 输入使用所选上游的原生 JSON Images API,因此该渠道必须支持 URL 编辑。模型权限、企业渠道选择、资金准入与结算同时适用于这两种输入。URL 必须使用公开的 HTTPS 且不得内嵌凭证;网关不会下载这些图片。其他原生 JSON 参数予以保留。gpt-image-2 默认 quality 为 medium。畸形的 URL 输入、图片缺失、不支持的流式请求、无效的图片数量以及无效的质量参数均会在资金准入或服务商外发前返回 HTTP 400。
POST /v1/images/generations请求示例
curl \
--request POST \
--url 'https://api.anyint.ai/v1/images/generations' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"model": "your-model-id",
"prompt": "A minimal paper sculpture of a cloud",
"n": 1
}'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
请求体
必填{
"model": "your-model-id",
"prompt": "A minimal paper sculpture of a cloud",
"n": 1
}响应
{
"created": 1700000000,
"data": [
{
"b64_json": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAAB"
}
]
}支持 multipart 上传图片或非流式 JSON URL 输入。JSON 格式需要 model、prompt 以及 1-16 张带有 image_url 的图片;mask 可包含一个 image_url。URL 输入使用所选上游的原生 JSON Images API,因此该渠道必须支持 URL 编辑。模型权限、企业渠道选择、资金准入与结算同时适用于这两种输入。URL 必须使用公开的 HTTPS 且不得内嵌凭证;网关不会下载这些图片。其他原生 JSON 参数予以保留。gpt-image-2 默认 quality 为 medium。畸形的 URL 输入、图片缺失、不支持的流式请求、无效的图片数量以及无效的质量参数均会在资金准入或服务商外发前返回 HTTP 400。
POST /openai/v1/images/generations请求示例
curl \
--request POST \
--url 'https://api.anyint.ai/openai/v1/images/generations' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"model": "your-model-id",
"prompt": "A minimal paper sculpture of a cloud",
"n": 1
}'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
请求体
必填{
"model": "your-model-id",
"prompt": "A minimal paper sculpture of a cloud",
"n": 1
}响应
{
"created": 1700000000,
"data": [
{
"b64_json": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAAB"
}
]
}模型
5 个端点查看各协议可用的模型。
请求示例
curl \
--request GET \
--url 'https://api.anyint.ai/openai/v1/models' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
响应
{
"object": "list",
"data": [
{
"id": "your-model-id",
"object": "model",
"created": 1767225600,
"owned_by": "configured-provider"
}
]
}请求示例
curl \
--request GET \
--url 'https://api.anyint.ai/v1/models' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
响应
{
"object": "list",
"data": [
{
"id": "your-model-id",
"object": "model",
"created": 1767225600,
"owned_by": "configured-provider"
}
]
}请求示例
curl \
--request GET \
--url 'https://api.anyint.ai/anthropic/v1/models' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
响应
{
"data": [
{
"id": "your-model-id",
"type": "model",
"display_name": "Configured model",
"created_at": "2026-01-01T00:00:00.000Z"
}
],
"has_more": false,
"first_id": "your-model-id",
"last_id": "your-model-id"
}请求示例
curl \
--request GET \
--url 'https://api.anyint.ai/gemini/v1beta/models' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
响应
{
"models": [
{
"name": "models/your-model-id",
"displayName": "Configured model",
"supportedGenerationMethods": [
"generateContent"
],
"inputTokenLimit": 8192,
"outputTokenLimit": 8192
}
]
}请求示例
curl \
--request GET \
--url 'https://api.anyint.ai/v1beta/models' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
响应
{
"candidates": [
{
"content": {
"role": "model",
"parts": [
{
"text": "Edge computing reduces latency."
}
]
}
}
]
}异步媒体
23 个端点创建并查看异步图像、视频和音乐任务。
Seedance 支持有效的图片和视频 asset:// 素材引用,包括混合的 reference_image 与 reference_video 内容。每个引用都必须属于企业当前的素材库。素材库不兼容的引用会在路由、创建任务或提交上游前返回 HTTP 400 authorized_asset_provider_mismatch,retryable=false,user_action=simplify_input。请先在当前素材库中登记所引用的图片和视频并更新引用,然后重试。
POST /v1/videos请求示例
curl \
--request POST \
--url 'https://api.anyint.ai/v1/videos' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"model": "your-model-name",
"prompt": "A calm landscape",
"duration_seconds": 5
}'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
请求体
必填{
"model": "your-model-name",
"prompt": "A calm landscape",
"duration_seconds": 5
}响应
{
"id": "task_example",
"taskId": "task_example",
"object": "video",
"status": "queued",
"created_at": 0
}请求示例
curl \
--request GET \
--url 'https://api.anyint.ai/v1/videos/<task_id>' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| task_id | path | string | 必填 | — |
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
响应
{
"id": "task_example",
"taskId": "task_example",
"object": "video",
"status": "queued",
"created_at": 0
}请求示例
curl \
--request GET \
--url 'https://api.anyint.ai/v1/videos/<task_id>/content' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/octet-stream'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| task_id | path | string | 必填 | — |
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
响应
<binary>Seedance 支持有效的图片和视频 asset:// 素材引用,包括混合的 reference_image 与 reference_video 内容。每个引用都必须属于企业当前的素材库。素材库不兼容的引用会在路由、创建任务或提交上游前返回 HTTP 400 authorized_asset_provider_mismatch,retryable=false,user_action=simplify_input。请先在当前素材库中登记所引用的图片和视频并更新引用,然后重试。
POST /openai/v1/videos请求示例
curl \
--request POST \
--url 'https://api.anyint.ai/openai/v1/videos' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"model": "your-model-name",
"prompt": "A calm landscape",
"duration_seconds": 5
}'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
请求体
必填{
"model": "your-model-name",
"prompt": "A calm landscape",
"duration_seconds": 5
}响应
{
"id": "task_example",
"taskId": "task_example",
"object": "video",
"status": "queued",
"created_at": 0
}请求示例
curl \
--request GET \
--url 'https://api.anyint.ai/openai/v1/videos/<task_id>' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| task_id | path | string | 必填 | — |
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
响应
{
"id": "task_example",
"taskId": "task_example",
"object": "video",
"status": "queued",
"created_at": 0
}请求示例
curl \
--request GET \
--url 'https://api.anyint.ai/openai/v1/videos/<task_id>/content' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/octet-stream'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| task_id | path | string | 必填 | — |
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
响应
<binary>请求示例
curl \
--request POST \
--url 'https://api.anyint.ai/v1/audio/generations' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"model": "your-model-name",
"prompt": "A calm landscape",
"duration_seconds": 5
}'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
请求体
必填{
"model": "your-model-name",
"prompt": "A calm landscape",
"duration_seconds": 5
}响应
{
"id": "task_example",
"taskId": "task_example",
"object": "audio",
"status": "queued",
"created_at": 0
}请求示例
curl \
--request GET \
--url 'https://api.anyint.ai/v1/audio/generations/<task_id>' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| task_id | path | string | 必填 | — |
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
响应
{
"id": "task_example",
"taskId": "task_example",
"object": "audio",
"status": "queued",
"created_at": 0
}请求示例
curl \
--request GET \
--url 'https://api.anyint.ai/v1/audio/generations/<task_id>/content' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/octet-stream'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| task_id | path | string | 必填 | — |
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
响应
<binary>请求示例
curl \
--request POST \
--url 'https://api.anyint.ai/openai/v1/audio/generations' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"model": "your-model-name",
"prompt": "A calm landscape",
"duration_seconds": 5
}'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
请求体
必填{
"model": "your-model-name",
"prompt": "A calm landscape",
"duration_seconds": 5
}响应
{
"id": "task_example",
"taskId": "task_example",
"object": "audio",
"status": "queued",
"created_at": 0
}请求示例
curl \
--request GET \
--url 'https://api.anyint.ai/openai/v1/audio/generations/<task_id>' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| task_id | path | string | 必填 | — |
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
响应
{
"id": "task_example",
"taskId": "task_example",
"object": "audio",
"status": "queued",
"created_at": 0
}请求示例
curl \
--request GET \
--url 'https://api.anyint.ai/openai/v1/audio/generations/<task_id>/content' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/octet-stream'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| task_id | path | string | 必填 | — |
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
响应
<binary>请求示例
curl \
--request POST \
--url 'https://api.anyint.ai/v1/async-tasks/image-generations' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"model": "your-model-id",
"prompt": "A minimal paper sculpture of a cloud"
}'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
请求体
必填{
"model": "your-model-id",
"prompt": "A minimal paper sculpture of a cloud"
}响应
{
"object": "async_task",
"task": {
"id": "task_example",
"requestId": "req_example",
"tenantId": "tenant_example",
"protocol": "openai",
"taskType": "image_generation",
"status": "submitted",
"input": {
"prompt": "Example prompt"
},
"artifacts": [],
"artifactCount": 0,
"artifact_count": 0,
"billingSessions": [],
"billing_sessions": [],
"createdAt": "2026-01-01T00:00:00.000Z",
"updatedAt": "2026-01-01T00:00:00.000Z"
},
"anyint": {
"request_id": "req_example",
"route_decision_id": "route_example"
},
"duplicate": true
}请求示例
curl \
--request POST \
--url 'https://api.anyint.ai/v1/async-tasks/video-generations' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"model": "your-model-id",
"prompt": "Slow aerial movement over a quiet coast",
"duration_seconds": 6,
"fps": 24
}'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
请求体
必填{
"model": "your-model-id",
"prompt": "Slow aerial movement over a quiet coast",
"duration_seconds": 6,
"fps": 24
}响应
{
"object": "async_task",
"task": {
"id": "task_example",
"requestId": "req_example",
"tenantId": "tenant_example",
"protocol": "openai",
"taskType": "video_generation",
"status": "submitted",
"input": {
"prompt": "Example prompt"
},
"artifacts": [],
"artifactCount": 0,
"artifact_count": 0,
"billingSessions": [],
"billing_sessions": [],
"createdAt": "2026-01-01T00:00:00.000Z",
"updatedAt": "2026-01-01T00:00:00.000Z"
},
"anyint": {
"request_id": "req_example",
"route_decision_id": "route_example"
},
"duplicate": true
}请求示例
curl \
--request POST \
--url 'https://api.anyint.ai/v1/videos/generations' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"model": "your-model-id",
"prompt": "Slow aerial movement over a quiet coast",
"duration_seconds": 6,
"fps": 24
}'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
请求体
必填{
"model": "your-model-id",
"prompt": "Slow aerial movement over a quiet coast",
"duration_seconds": 6,
"fps": 24
}响应
{
"object": "async_task",
"task": {
"id": "task_example",
"requestId": "req_example",
"tenantId": "tenant_example",
"protocol": "openai",
"taskType": "video_generation",
"status": "submitted",
"input": {
"prompt": "Example prompt"
},
"artifacts": [],
"artifactCount": 0,
"artifact_count": 0,
"billingSessions": [],
"billing_sessions": [],
"createdAt": "2026-01-01T00:00:00.000Z",
"updatedAt": "2026-01-01T00:00:00.000Z"
},
"anyint": {
"request_id": "req_example",
"route_decision_id": "route_example"
},
"duplicate": true
}请求示例
curl \
--request POST \
--url 'https://api.anyint.ai/v1/async-tasks/music-generations' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"model": "your-model-id",
"prompt": "Warm ambient music with soft piano",
"duration_seconds": 30
}'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
请求体
必填{
"model": "your-model-id",
"prompt": "Warm ambient music with soft piano",
"duration_seconds": 30
}响应
{
"object": "async_task",
"task": {
"id": "task_example",
"requestId": "req_example",
"tenantId": "tenant_example",
"protocol": "openai",
"taskType": "music_generation",
"status": "submitted",
"input": {
"prompt": "Example prompt"
},
"artifacts": [],
"artifactCount": 0,
"artifact_count": 0,
"billingSessions": [],
"billing_sessions": [],
"createdAt": "2026-01-01T00:00:00.000Z",
"updatedAt": "2026-01-01T00:00:00.000Z"
},
"anyint": {
"request_id": "req_example",
"route_decision_id": "route_example"
},
"duplicate": true
}请求示例
curl \
--request POST \
--url 'https://api.anyint.ai/v1/music/generations' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"model": "your-model-id",
"prompt": "Warm ambient music with soft piano",
"duration_seconds": 30
}'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
请求体
必填{
"model": "your-model-id",
"prompt": "Warm ambient music with soft piano",
"duration_seconds": 30
}响应
{
"object": "async_task",
"task": {
"id": "task_example",
"requestId": "req_example",
"tenantId": "tenant_example",
"protocol": "openai",
"taskType": "music_generation",
"status": "submitted",
"input": {
"prompt": "Example prompt"
},
"artifacts": [],
"artifactCount": 0,
"artifact_count": 0,
"billingSessions": [],
"billing_sessions": [],
"createdAt": "2026-01-01T00:00:00.000Z",
"updatedAt": "2026-01-01T00:00:00.000Z"
},
"anyint": {
"request_id": "req_example",
"route_decision_id": "route_example"
},
"duplicate": true
}请求示例
curl \
--request GET \
--url 'https://api.anyint.ai/v1/async-tasks' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
响应
{
"object": "list",
"data": [
{
"id": "task_example",
"requestId": "req_example",
"tenantId": "tenant_example",
"protocol": "openai",
"taskType": "image_generation",
"status": "queued",
"input": {
"prompt": "Example prompt"
},
"artifacts": [],
"artifactCount": 0,
"artifact_count": 0,
"billingSessions": [],
"billing_sessions": [],
"createdAt": "2026-01-01T00:00:00.000Z",
"updatedAt": "2026-01-01T00:00:00.000Z"
}
]
}请求示例
curl \
--request GET \
--url 'https://api.anyint.ai/v1/async-tasks/<task_id>' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| task_id | path | string | 必填 | — |
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
响应
{
"object": "async_task",
"task": {
"id": "task_example",
"requestId": "req_example",
"tenantId": "tenant_example",
"protocol": "openai",
"taskType": "image_generation",
"status": "queued",
"input": {
"prompt": "Example prompt"
},
"artifacts": [],
"artifactCount": 0,
"artifact_count": 0,
"billingSessions": [],
"billing_sessions": [],
"createdAt": "2026-01-01T00:00:00.000Z",
"updatedAt": "2026-01-01T00:00:00.000Z"
}
}请求示例
curl \
--request GET \
--url 'https://api.anyint.ai/v1/tasks/<task_id>' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| task_id | path | string | 必填 | — |
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
响应
{
"object": "generation_task",
"task": {
"id": "task_example",
"requestId": "req_example",
"tenantId": "tenant_example",
"protocol": "openai",
"taskType": "image_generation",
"status": "queued",
"input": {
"prompt": "Example prompt"
},
"artifacts": [],
"artifactCount": 0,
"artifact_count": 0,
"billingSessions": [],
"billing_sessions": [],
"createdAt": "2026-01-01T00:00:00.000Z",
"updatedAt": "2026-01-01T00:00:00.000Z"
}
}请求示例
curl \
--request POST \
--url 'https://api.anyint.ai/v1/tasks/<task_id>/cancel' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| task_id | path | string | 必填 | — |
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
响应
{
"object": "generation_task",
"task": {
"id": "task_example",
"requestId": "req_example",
"tenantId": "tenant_example",
"protocol": "openai",
"taskType": "image_generation",
"status": "queued",
"input": {
"prompt": "Example prompt"
},
"artifacts": [],
"artifactCount": 0,
"artifact_count": 0,
"billingSessions": [],
"billing_sessions": [],
"createdAt": "2026-01-01T00:00:00.000Z",
"updatedAt": "2026-01-01T00:00:00.000Z"
}
}请求示例
curl \
--request POST \
--url 'https://api.anyint.ai/v1/async-tasks/<task_id>/cancel' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| task_id | path | string | 必填 | — |
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
响应
{
"object": "generation_task",
"task": {
"id": "task_example",
"requestId": "req_example",
"tenantId": "tenant_example",
"protocol": "openai",
"taskType": "image_generation",
"status": "queued",
"input": {
"prompt": "Example prompt"
},
"artifacts": [],
"artifactCount": 0,
"artifact_count": 0,
"billingSessions": [],
"billing_sessions": [],
"createdAt": "2026-01-01T00:00:00.000Z",
"updatedAt": "2026-01-01T00:00:00.000Z"
}
}请求示例
curl \
--request GET \
--url 'https://api.anyint.ai/v1/async-tasks/<task_id>/artifacts/<artifact_id>?tenant_id=<tenant_id>&expires_at=<expires_at>&signature=<signature>' \
--header 'Accept: application/octet-stream'身份验证
无需身份验证
参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| task_id | path | string | 必填 | — |
| artifact_id | path | string | 必填 | — |
| tenant_id | query | string | 必填 | — |
| expires_at | query | integer | 必填 | — |
| signature | query | string | 必填 | — |
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
响应
<binary>Anthropic 消息
4 个端点使用 Anthropic 原生消息、Token 统计和模型发现能力。
启用计费时,tools 或 Responses input.additional_tools 中声明的内置网络搜索要求已编译的价格规则覆盖 web_search_queries 及对应请求维度。命名空间工具声明会被检查,但不会将客户端函数视为内置搜索。在初始资金预留前,路由按顺序检查符合条件且已授权的候选者,并跳过未配置所需搜索计价的候选者。必要的渠道/提供商及连续性亲和性限制仍会强制执行。若没有允许的候选者具备计价覆盖,准入将在提供方派发或资金预留前返回 HTTP 503 search_tool_pricing_not_configured。每个实际的故障回退及供应层级候选者都会在派发前再次检查;缺失计价绝不消耗提供方尝试次数。对于企业后付费请求,结算前将根据剩余授权预算检查超出初始估算的实际提供方用量。预算拒绝会保留已记录的用量和价格以供核对。客户端函数工具不受影响。 原生请求保留提供方参数,但须符合所选模型的官方支持。跨协议请求通过请求中间表示(IR)映射受支持的内容和控制。未映射的扩展和近似控制记录在转换诊断中,而不会拒绝其他可用的请求。畸形的源内容仍返回 HTTP 400。无法表示的跨协议工具声明会在资金准入前返回 HTTP 400,而不会被静默丢弃;符合条件的原生路由可保留原生专属工具。Anthropic stop_sequences 映射到 Chat 的 stop;不会伪造上游未报告的匹配序列。使用 Responses previous_response_id/conversation、Anthropic thread 或 Gemini cachedContent 的请求需要其服务端状态。即使输入包含重复的历史记录,这些引用也绝不会被丢弃。路由会排除无法保留状态的转换,并优先选择符合条件的原生路由;状态归属仍取决于原始服务商/账户以及现有的连续性亲和性检查。如果所有候选均因此原因被排除,则在服务商派发前返回 HTTP 422 conversation_state_unavailable。网关当前不会物化引用的历史。仅原生协议可用性并不能证明所选账户中存在私有状态 ID。回退不会自动将 json_schema 降级为 json_object。 配置支持时,Chat Completions、Responses、Anthropic Messages 和 Gemini generateContent 可使用 model=auto 或 auto-cn。在特征打分之前,智能路由会过滤原生 json_schema/json_object 支持、显式关闭思考支持、完整输入长度加上请求的输出预留以及所需的输入模态。文本上下文长度包括完整的系统/历史/工具定义及结果和 JSON 结构,在分词器集成前按每个预估文本 token 对应一个 UTF-16 字符计算。在此预估中,显式媒体传输载荷会被替换为类型占位符;Base64 长度不是媒体 token 计数。实际媒体 token 用量和限制仍取决于特定服务商并在上游校验。JSON 和思考关闭支持来自已发布的 llm_capabilities(jsonSchema、jsonObject、reasoning、reasoningDisable);缺失的硬能力事实不视为支持。无推理能力的模型满足思考关闭。推理强度、摘要详细度、隐藏思考和可选输出元数据不作为候选者过滤条件。配置 Redis 时,Auto 首先检查租户、API 密钥、路由模式和协议范围内的显式客户端会话绑定,然后检查历史指纹。会话提取优先采用 X-Claude-Code-Session-Id、X-OpenCode-Session-Id、X-DeepSeek-Harness-Session-Id、X-QwenWork-Session-Id 和 thread-id,其次是 Responses client_metadata session_id/thread_id 以及 JSON x-codex-turn-metadata 中的相同字段。通用的 X-Session-Id、session_id、session-id、X-Cursor-Session 和 X-OpenClaw-Session-Id 紧随其后,接着是请求体中的 session_id、sessionId、metadata.session_id 和 metadata.sessionId。Anthropic 还接受 JSON metadata.user_id 内部的 session_id。X-Task-ID、X-OpenCode-Session 和 X-Session-Affinity 仅作为回退标识。KimiCLI/ User-Agent 还会额外启用已知的 Chat Completions prompt_cache_key 或 Anthropic 纯文本 metadata.user_id 会话惯例。缺失或畸形的标识符不会导致请求被拒绝。用户/账户、请求、提示词、轮次及父级标识符不会被全局视为会话 ID。会话查找失败仍会尝试历史匹配;两种绑定仅在成功完成时更新。History v2 排除非消息角色/控制项和不完整的工具调用标识符;没有 User 边界意味着包含所有可用历史。有效命中会在重新检查当前候选者资格后跳过 Jev 打分及其路由费用;若该绑定模型失败,Auto 将绕过绑定并评分一次以填充剩余的不同模型尝试。未命中和缓存失败使用正常评分。绑定在 24 小时后过期,且仅在成功的 JSON 或完整的 SSE 响应后写入;取消、未完成、模糊或过大的流不会创建绑定。智能路由对 API 密钥和协议允许的剩余当前网关目录模型进行评分,然后选定的具体模型遵循现有的权限、渠道路由和计费规则。对于 auto/auto-cn,来自 Chat Completions、Responses 和 Anthropic 的 Vertex Gemini 文本请求使用 Vertex 兼容 OpenAI 的 Chat 端点,采用相同的账户、模型和已发布的 Gemini 资费。Chat 消息/工具载荷予以保留;Responses 和 Anthropic 仅转换为 Chat。包含视频的 Auto 请求保留原生 Gemini generateContent/streamGenerateContent 转换,因为 Vertex Chat 拒绝 video_url;媒体字节、混合音频、账户和 Gemini 计价予以保留。显式模型请求和原生 Gemini/媒体路径保留其现有路由。价格和上下文限制来自当前已发布的目录;缺失的上下文限制可使用版本化能力快照并记录日志。可选能力覆盖不定义候选列表。任务特征失败记录为降级并使用中性需求值。配置或打分凭证缺失、目录无效或无符合条件的模型返回 HTTP 503(auto_routing_not_configured、auto_routing_configuration_invalid、auto_routing_scorer_unavailable、auto_routing_no_candidates)。选择失败返回 auto_routing_failed。对于 Responses 历史,仅消息项(包括省略 type)需要 role;非消息项保留在完整上游请求中,不参与评分。Jev 仅接收用户/助手文本及最多 500 个加权字符的系统前缀;工具定义、调用/结果和其他角色均排除。评分前检查完整请求中的图像、音频、视频及文件内容块。已发布模型的输入模态必须覆盖所有附件类型,选中及回退渠道也必须在 metadata.input_modalities(亦接受 inputModalities)中显式声明这些类型;不兼容渠道在派发前返回 capability_mismatch。未知 MIME 类型和不透明文件引用要求文件支持。媒体字节、URL 和文件 ID 从 Jev 材料中排除,替换为附件类型占位符;原始请求保持不变。不引入多模态需求特征或能力评分。非文本输出、生图工具和服务端存储的 Responses 连续会话仍需要显式模型,返回 HTTP 400 auto_routing_request_unsupported。在每次模型尝试不成功后,Auto 会尝试下一个排名的模型,包括任何非 2xx 响应、通用 HTTP 400 校验错误、服务商拒绝、5xx、超时、传输错误和未分类的本地执行失败。失败分类和不确定的服务商费用不会阻止回退。每次尝试都保留自己的结算凭据;重试不会将不确定的服务商结果转换为已确认的零费用。一次特征评估最多尝试三个不同的已排名模型。每次尝试在独立的执行 ID 下重复现有的授权、配额、速率限制、路由和资金检查。公开的 X-Request-Id 保持稳定;执行记录和计费元数据保留其关联。客户端取消或成功交付响应将停止跨模型回退。已交付给客户端的流不会重新启动。每个候选者仍必须通过授权和资金检查;未通过的检查绝不会授权上游外发。当所有候选者均失败时,将返回最终尝试的错误。显式模型请求不使用此回退。在需要 Jev 评分的最终模型执行成功后,Auto 会在公开父请求 ID 上追加一次平台路由费用:min(20 * L / 1000000 + 0.01505, 0.2) 积分,其中 L 是压缩后 Jev 状态的 UTF-16 字符串长度(对象的 JSON 序列化),在各次打分调用中统一计量一次。1 美元等于 100 积分;费用四舍五入到微美元(0.0001 积分)。失败或不完整的流以及失败的最终执行不产生此费用。计费模式为 auto,包括 auto-cn 请求。公开 Auto 请求 ID 的请求费用查询包含其路由费和所有已结算子执行费用。
POST /anthropic/v1/messages请求示例
curl \
--request POST \
--url 'https://api.anyint.ai/anthropic/v1/messages' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"model": "your-model-id",
"max_tokens": 256,
"messages": [
{
"role": "user",
"content": "Explain edge computing briefly."
}
]
}'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| X-Client-Message-Id | header | string | 可选 | 启用租户范围的持久执行去重。只能使用相同请求体和 API 密钥重用消息 ID。已完成或可能已经派发的请求不会因到期或 Redis 数据丢失而再次执行。派发后即使上游报错或结算回滚,也须使用新消息 ID 发起另一次执行;派发前失败可使用原 ID 重试。 |
| X-Resume-Message-Id | header | string | 可选 | 使用原 API 密钥和相同请求体重放已生成的 SSE 流,不会再次调用上游或计费。缓存保留 10 分钟,输出总量上限为 4 MiB;中断后的续写须使用新的消息 ID。 |
| X-Resume-From-Offset | header | integer | 可选 | 已接收的完整 SSE 事件数,与最后一个 SSE id 一致,从 0 开始;单位不是 UTF-8 字节、令牌或字符。优先于 Last-Event-ID。 |
| Last-Event-ID | header | integer | 可选 | 未提供 X-Resume-From-Offset 时使用的完整 SSE 事件偏移量。 |
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
请求体
必填{
"model": "your-model-id",
"max_tokens": 256,
"messages": [
{
"role": "user",
"content": "Explain edge computing briefly."
}
]
}响应
{
"id": "msg_example",
"type": "message",
"role": "assistant",
"content": [
{
"type": "text",
"text": "Edge computing runs workloads near the data source."
}
]
}请求示例
curl \
--request POST \
--url 'https://api.anyint.ai/anthropic/v1/messages/count_tokens' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"model": "your-model-id",
"messages": [
{
"role": "user",
"content": "Hello"
}
]
}'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
请求体
必填{
"model": "your-model-id",
"messages": [
{
"role": "user",
"content": "Hello"
}
]
}响应
{
"input_tokens": 12
}启用计费时,tools 或 Responses input.additional_tools 中声明的内置网络搜索要求已编译的价格规则覆盖 web_search_queries 及对应请求维度。命名空间工具声明会被检查,但不会将客户端函数视为内置搜索。在初始资金预留前,路由按顺序检查符合条件且已授权的候选者,并跳过未配置所需搜索计价的候选者。必要的渠道/提供商及连续性亲和性限制仍会强制执行。若没有允许的候选者具备计价覆盖,准入将在提供方派发或资金预留前返回 HTTP 503 search_tool_pricing_not_configured。每个实际的故障回退及供应层级候选者都会在派发前再次检查;缺失计价绝不消耗提供方尝试次数。对于企业后付费请求,结算前将根据剩余授权预算检查超出初始估算的实际提供方用量。预算拒绝会保留已记录的用量和价格以供核对。客户端函数工具不受影响。 原生请求保留提供方参数,但须符合所选模型的官方支持。跨协议请求通过请求中间表示(IR)映射受支持的内容和控制。未映射的扩展和近似控制记录在转换诊断中,而不会拒绝其他可用的请求。畸形的源内容仍返回 HTTP 400。无法表示的跨协议工具声明会在资金准入前返回 HTTP 400,而不会被静默丢弃;符合条件的原生路由可保留原生专属工具。Anthropic stop_sequences 映射到 Chat 的 stop;不会伪造上游未报告的匹配序列。使用 Responses previous_response_id/conversation、Anthropic thread 或 Gemini cachedContent 的请求需要其服务端状态。即使输入包含重复的历史记录,这些引用也绝不会被丢弃。路由会排除无法保留状态的转换,并优先选择符合条件的原生路由;状态归属仍取决于原始服务商/账户以及现有的连续性亲和性检查。如果所有候选均因此原因被排除,则在服务商派发前返回 HTTP 422 conversation_state_unavailable。网关当前不会物化引用的历史。仅原生协议可用性并不能证明所选账户中存在私有状态 ID。回退不会自动将 json_schema 降级为 json_object。 配置支持时,Chat Completions、Responses、Anthropic Messages 和 Gemini generateContent 可使用 model=auto 或 auto-cn。在特征打分之前,智能路由会过滤原生 json_schema/json_object 支持、显式关闭思考支持、完整输入长度加上请求的输出预留以及所需的输入模态。文本上下文长度包括完整的系统/历史/工具定义及结果和 JSON 结构,在分词器集成前按每个预估文本 token 对应一个 UTF-16 字符计算。在此预估中,显式媒体传输载荷会被替换为类型占位符;Base64 长度不是媒体 token 计数。实际媒体 token 用量和限制仍取决于特定服务商并在上游校验。JSON 和思考关闭支持来自已发布的 llm_capabilities(jsonSchema、jsonObject、reasoning、reasoningDisable);缺失的硬能力事实不视为支持。无推理能力的模型满足思考关闭。推理强度、摘要详细度、隐藏思考和可选输出元数据不作为候选者过滤条件。配置 Redis 时,Auto 首先检查租户、API 密钥、路由模式和协议范围内的显式客户端会话绑定,然后检查历史指纹。会话提取优先采用 X-Claude-Code-Session-Id、X-OpenCode-Session-Id、X-DeepSeek-Harness-Session-Id、X-QwenWork-Session-Id 和 thread-id,其次是 Responses client_metadata session_id/thread_id 以及 JSON x-codex-turn-metadata 中的相同字段。通用的 X-Session-Id、session_id、session-id、X-Cursor-Session 和 X-OpenClaw-Session-Id 紧随其后,接着是请求体中的 session_id、sessionId、metadata.session_id 和 metadata.sessionId。Anthropic 还接受 JSON metadata.user_id 内部的 session_id。X-Task-ID、X-OpenCode-Session 和 X-Session-Affinity 仅作为回退标识。KimiCLI/ User-Agent 还会额外启用已知的 Chat Completions prompt_cache_key 或 Anthropic 纯文本 metadata.user_id 会话惯例。缺失或畸形的标识符不会导致请求被拒绝。用户/账户、请求、提示词、轮次及父级标识符不会被全局视为会话 ID。会话查找失败仍会尝试历史匹配;两种绑定仅在成功完成时更新。History v2 排除非消息角色/控制项和不完整的工具调用标识符;没有 User 边界意味着包含所有可用历史。有效命中会在重新检查当前候选者资格后跳过 Jev 打分及其路由费用;若该绑定模型失败,Auto 将绕过绑定并评分一次以填充剩余的不同模型尝试。未命中和缓存失败使用正常评分。绑定在 24 小时后过期,且仅在成功的 JSON 或完整的 SSE 响应后写入;取消、未完成、模糊或过大的流不会创建绑定。智能路由对 API 密钥和协议允许的剩余当前网关目录模型进行评分,然后选定的具体模型遵循现有的权限、渠道路由和计费规则。对于 auto/auto-cn,来自 Chat Completions、Responses 和 Anthropic 的 Vertex Gemini 文本请求使用 Vertex 兼容 OpenAI 的 Chat 端点,采用相同的账户、模型和已发布的 Gemini 资费。Chat 消息/工具载荷予以保留;Responses 和 Anthropic 仅转换为 Chat。包含视频的 Auto 请求保留原生 Gemini generateContent/streamGenerateContent 转换,因为 Vertex Chat 拒绝 video_url;媒体字节、混合音频、账户和 Gemini 计价予以保留。显式模型请求和原生 Gemini/媒体路径保留其现有路由。价格和上下文限制来自当前已发布的目录;缺失的上下文限制可使用版本化能力快照并记录日志。可选能力覆盖不定义候选列表。任务特征失败记录为降级并使用中性需求值。配置或打分凭证缺失、目录无效或无符合条件的模型返回 HTTP 503(auto_routing_not_configured、auto_routing_configuration_invalid、auto_routing_scorer_unavailable、auto_routing_no_candidates)。选择失败返回 auto_routing_failed。对于 Responses 历史,仅消息项(包括省略 type)需要 role;非消息项保留在完整上游请求中,不参与评分。Jev 仅接收用户/助手文本及最多 500 个加权字符的系统前缀;工具定义、调用/结果和其他角色均排除。评分前检查完整请求中的图像、音频、视频及文件内容块。已发布模型的输入模态必须覆盖所有附件类型,选中及回退渠道也必须在 metadata.input_modalities(亦接受 inputModalities)中显式声明这些类型;不兼容渠道在派发前返回 capability_mismatch。未知 MIME 类型和不透明文件引用要求文件支持。媒体字节、URL 和文件 ID 从 Jev 材料中排除,替换为附件类型占位符;原始请求保持不变。不引入多模态需求特征或能力评分。非文本输出、生图工具和服务端存储的 Responses 连续会话仍需要显式模型,返回 HTTP 400 auto_routing_request_unsupported。在每次模型尝试不成功后,Auto 会尝试下一个排名的模型,包括任何非 2xx 响应、通用 HTTP 400 校验错误、服务商拒绝、5xx、超时、传输错误和未分类的本地执行失败。失败分类和不确定的服务商费用不会阻止回退。每次尝试都保留自己的结算凭据;重试不会将不确定的服务商结果转换为已确认的零费用。一次特征评估最多尝试三个不同的已排名模型。每次尝试在独立的执行 ID 下重复现有的授权、配额、速率限制、路由和资金检查。公开的 X-Request-Id 保持稳定;执行记录和计费元数据保留其关联。客户端取消或成功交付响应将停止跨模型回退。已交付给客户端的流不会重新启动。每个候选者仍必须通过授权和资金检查;未通过的检查绝不会授权上游外发。当所有候选者均失败时,将返回最终尝试的错误。显式模型请求不使用此回退。在需要 Jev 评分的最终模型执行成功后,Auto 会在公开父请求 ID 上追加一次平台路由费用:min(20 * L / 1000000 + 0.01505, 0.2) 积分,其中 L 是压缩后 Jev 状态的 UTF-16 字符串长度(对象的 JSON 序列化),在各次打分调用中统一计量一次。1 美元等于 100 积分;费用四舍五入到微美元(0.0001 积分)。失败或不完整的流以及失败的最终执行不产生此费用。计费模式为 auto,包括 auto-cn 请求。公开 Auto 请求 ID 的请求费用查询包含其路由费和所有已结算子执行费用。
POST /v1/messages请求示例
curl \
--request POST \
--url 'https://api.anyint.ai/v1/messages' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"model": "your-model-id",
"max_tokens": 256,
"messages": [
{
"role": "user",
"content": "Explain edge computing briefly."
}
]
}'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| X-Client-Message-Id | header | string | 可选 | 启用租户范围的持久执行去重。只能使用相同请求体和 API 密钥重用消息 ID。已完成或可能已经派发的请求不会因到期或 Redis 数据丢失而再次执行。派发后即使上游报错或结算回滚,也须使用新消息 ID 发起另一次执行;派发前失败可使用原 ID 重试。 |
| X-Resume-Message-Id | header | string | 可选 | 使用原 API 密钥和相同请求体重放已生成的 SSE 流,不会再次调用上游或计费。缓存保留 10 分钟,输出总量上限为 4 MiB;中断后的续写须使用新的消息 ID。 |
| X-Resume-From-Offset | header | integer | 可选 | 已接收的完整 SSE 事件数,与最后一个 SSE id 一致,从 0 开始;单位不是 UTF-8 字节、令牌或字符。优先于 Last-Event-ID。 |
| Last-Event-ID | header | integer | 可选 | 未提供 X-Resume-From-Offset 时使用的完整 SSE 事件偏移量。 |
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
请求体
必填{
"model": "your-model-id",
"max_tokens": 256,
"messages": [
{
"role": "user",
"content": "Explain edge computing briefly."
}
]
}响应
{
"id": "msg_example",
"type": "message",
"role": "assistant",
"content": [
{
"type": "text",
"text": "Edge computing runs workloads near the data source."
}
]
}请求示例
curl \
--request POST \
--url 'https://api.anyint.ai/v1/messages/count_tokens' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"model": "your-model-id",
"messages": [
{
"role": "user",
"content": "Hello"
}
]
}'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
请求体
必填{
"model": "your-model-id",
"messages": [
{
"role": "user",
"content": "Hello"
}
]
}响应
{
"input_tokens": 12
}Gemini 内容
8 个端点使用 Gemini 原生内容生成与流式输出。
Gemini Developer API 上的 Gemini 4 Argon 仅支持 Standard 推理。请省略 serviceTier/service_tier 或将其设为 standard;其他取值会在外发上游前返回 HTTP 400。 启用计费时,tools 或 Responses input.additional_tools 中声明的内置网络搜索要求已编译的价格规则覆盖 web_search_queries 及对应请求维度。命名空间工具声明会被检查,但不会将客户端函数视为内置搜索。在初始资金预留前,路由按顺序检查符合条件且已授权的候选者,并跳过未配置所需搜索计价的候选者。必要的渠道/提供商及连续性亲和性限制仍会强制执行。若没有允许的候选者具备计价覆盖,准入将在提供方派发或资金预留前返回 HTTP 503 search_tool_pricing_not_configured。每个实际的故障回退及供应层级候选者都会在派发前再次检查;缺失计价绝不消耗提供方尝试次数。对于企业后付费请求,结算前将根据剩余授权预算检查超出初始估算的实际提供方用量。预算拒绝会保留已记录的用量和价格以供核对。客户端函数工具不受影响。 原生请求保留提供方参数,但须符合所选模型的官方支持。跨协议请求通过请求中间表示(IR)映射受支持的内容和控制。未映射的扩展和近似控制记录在转换诊断中,而不会拒绝其他可用的请求。畸形的源内容仍返回 HTTP 400。无法表示的跨协议工具声明会在资金准入前返回 HTTP 400,而不会被静默丢弃;符合条件的原生路由可保留原生专属工具。Anthropic stop_sequences 映射到 Chat 的 stop;不会伪造上游未报告的匹配序列。使用 Responses previous_response_id/conversation、Anthropic thread 或 Gemini cachedContent 的请求需要其服务端状态。即使输入包含重复的历史记录,这些引用也绝不会被丢弃。路由会排除无法保留状态的转换,并优先选择符合条件的原生路由;状态归属仍取决于原始服务商/账户以及现有的连续性亲和性检查。如果所有候选均因此原因被排除,则在服务商派发前返回 HTTP 422 conversation_state_unavailable。网关当前不会物化引用的历史。仅原生协议可用性并不能证明所选账户中存在私有状态 ID。回退不会自动将 json_schema 降级为 json_object。 配置支持时,Chat Completions、Responses、Anthropic Messages 和 Gemini generateContent 可使用 model=auto 或 auto-cn。在特征打分之前,智能路由会过滤原生 json_schema/json_object 支持、显式关闭思考支持、完整输入长度加上请求的输出预留以及所需的输入模态。文本上下文长度包括完整的系统/历史/工具定义及结果和 JSON 结构,在分词器集成前按每个预估文本 token 对应一个 UTF-16 字符计算。在此预估中,显式媒体传输载荷会被替换为类型占位符;Base64 长度不是媒体 token 计数。实际媒体 token 用量和限制仍取决于特定服务商并在上游校验。JSON 和思考关闭支持来自已发布的 llm_capabilities(jsonSchema、jsonObject、reasoning、reasoningDisable);缺失的硬能力事实不视为支持。无推理能力的模型满足思考关闭。推理强度、摘要详细度、隐藏思考和可选输出元数据不作为候选者过滤条件。配置 Redis 时,Auto 首先检查租户、API 密钥、路由模式和协议范围内的显式客户端会话绑定,然后检查历史指纹。会话提取优先采用 X-Claude-Code-Session-Id、X-OpenCode-Session-Id、X-DeepSeek-Harness-Session-Id、X-QwenWork-Session-Id 和 thread-id,其次是 Responses client_metadata session_id/thread_id 以及 JSON x-codex-turn-metadata 中的相同字段。通用的 X-Session-Id、session_id、session-id、X-Cursor-Session 和 X-OpenClaw-Session-Id 紧随其后,接着是请求体中的 session_id、sessionId、metadata.session_id 和 metadata.sessionId。Anthropic 还接受 JSON metadata.user_id 内部的 session_id。X-Task-ID、X-OpenCode-Session 和 X-Session-Affinity 仅作为回退标识。KimiCLI/ User-Agent 还会额外启用已知的 Chat Completions prompt_cache_key 或 Anthropic 纯文本 metadata.user_id 会话惯例。缺失或畸形的标识符不会导致请求被拒绝。用户/账户、请求、提示词、轮次及父级标识符不会被全局视为会话 ID。会话查找失败仍会尝试历史匹配;两种绑定仅在成功完成时更新。History v2 排除非消息角色/控制项和不完整的工具调用标识符;没有 User 边界意味着包含所有可用历史。有效命中会在重新检查当前候选者资格后跳过 Jev 打分及其路由费用;若该绑定模型失败,Auto 将绕过绑定并评分一次以填充剩余的不同模型尝试。未命中和缓存失败使用正常评分。绑定在 24 小时后过期,且仅在成功的 JSON 或完整的 SSE 响应后写入;取消、未完成、模糊或过大的流不会创建绑定。智能路由对 API 密钥和协议允许的剩余当前网关目录模型进行评分,然后选定的具体模型遵循现有的权限、渠道路由和计费规则。对于 auto/auto-cn,来自 Chat Completions、Responses 和 Anthropic 的 Vertex Gemini 文本请求使用 Vertex 兼容 OpenAI 的 Chat 端点,采用相同的账户、模型和已发布的 Gemini 资费。Chat 消息/工具载荷予以保留;Responses 和 Anthropic 仅转换为 Chat。包含视频的 Auto 请求保留原生 Gemini generateContent/streamGenerateContent 转换,因为 Vertex Chat 拒绝 video_url;媒体字节、混合音频、账户和 Gemini 计价予以保留。显式模型请求和原生 Gemini/媒体路径保留其现有路由。价格和上下文限制来自当前已发布的目录;缺失的上下文限制可使用版本化能力快照并记录日志。可选能力覆盖不定义候选列表。任务特征失败记录为降级并使用中性需求值。配置或打分凭证缺失、目录无效或无符合条件的模型返回 HTTP 503(auto_routing_not_configured、auto_routing_configuration_invalid、auto_routing_scorer_unavailable、auto_routing_no_candidates)。选择失败返回 auto_routing_failed。对于 Responses 历史,仅消息项(包括省略 type)需要 role;非消息项保留在完整上游请求中,不参与评分。Jev 仅接收用户/助手文本及最多 500 个加权字符的系统前缀;工具定义、调用/结果和其他角色均排除。评分前检查完整请求中的图像、音频、视频及文件内容块。已发布模型的输入模态必须覆盖所有附件类型,选中及回退渠道也必须在 metadata.input_modalities(亦接受 inputModalities)中显式声明这些类型;不兼容渠道在派发前返回 capability_mismatch。未知 MIME 类型和不透明文件引用要求文件支持。媒体字节、URL 和文件 ID 从 Jev 材料中排除,替换为附件类型占位符;原始请求保持不变。不引入多模态需求特征或能力评分。非文本输出、生图工具和服务端存储的 Responses 连续会话仍需要显式模型,返回 HTTP 400 auto_routing_request_unsupported。在每次模型尝试不成功后,Auto 会尝试下一个排名的模型,包括任何非 2xx 响应、通用 HTTP 400 校验错误、服务商拒绝、5xx、超时、传输错误和未分类的本地执行失败。失败分类和不确定的服务商费用不会阻止回退。每次尝试都保留自己的结算凭据;重试不会将不确定的服务商结果转换为已确认的零费用。一次特征评估最多尝试三个不同的已排名模型。每次尝试在独立的执行 ID 下重复现有的授权、配额、速率限制、路由和资金检查。公开的 X-Request-Id 保持稳定;执行记录和计费元数据保留其关联。客户端取消或成功交付响应将停止跨模型回退。已交付给客户端的流不会重新启动。每个候选者仍必须通过授权和资金检查;未通过的检查绝不会授权上游外发。当所有候选者均失败时,将返回最终尝试的错误。显式模型请求不使用此回退。在需要 Jev 评分的最终模型执行成功后,Auto 会在公开父请求 ID 上追加一次平台路由费用:min(20 * L / 1000000 + 0.01505, 0.2) 积分,其中 L 是压缩后 Jev 状态的 UTF-16 字符串长度(对象的 JSON 序列化),在各次打分调用中统一计量一次。1 美元等于 100 积分;费用四舍五入到微美元(0.0001 积分)。失败或不完整的流以及失败的最终执行不产生此费用。计费模式为 auto,包括 auto-cn 请求。公开 Auto 请求 ID 的请求费用查询包含其路由费和所有已结算子执行费用。
POST /gemini/v1beta/models/{model}:generateContent请求示例
curl \
--request POST \
--url 'https://api.anyint.ai/gemini/v1beta/models/<model>:generateContent' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"contents": [
{
"parts": [
{
"text": "Explain edge computing briefly."
}
]
}
]
}'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| model | path | string | 必填 | — |
| X-Client-Message-Id | header | string | 可选 | 启用租户范围的持久执行去重。只能使用相同请求体和 API 密钥重用消息 ID。已完成或可能已经派发的请求不会因到期或 Redis 数据丢失而再次执行。派发后即使上游报错或结算回滚,也须使用新消息 ID 发起另一次执行;派发前失败可使用原 ID 重试。 |
| X-Resume-Message-Id | header | string | 可选 | 使用原 API 密钥和相同请求体重放已生成的 SSE 流,不会再次调用上游或计费。缓存保留 10 分钟,输出总量上限为 4 MiB;中断后的续写须使用新的消息 ID。 |
| X-Resume-From-Offset | header | integer | 可选 | 已接收的完整 SSE 事件数,与最后一个 SSE id 一致,从 0 开始;单位不是 UTF-8 字节、令牌或字符。优先于 Last-Event-ID。 |
| Last-Event-ID | header | integer | 可选 | 未提供 X-Resume-From-Offset 时使用的完整 SSE 事件偏移量。 |
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
请求体
必填{
"contents": [
{
"parts": [
{
"text": "Explain edge computing briefly."
}
]
}
]
}响应
{
"candidates": [
{
"content": {
"role": "model",
"parts": [
{
"text": "Edge computing reduces latency."
}
]
}
}
]
}Gemini Developer API 上的 Gemini 4 Argon 仅支持 Standard 推理。请省略 serviceTier/service_tier 或将其设为 standard;其他取值会在外发上游前返回 HTTP 400。 启用计费时,tools 或 Responses input.additional_tools 中声明的内置网络搜索要求已编译的价格规则覆盖 web_search_queries 及对应请求维度。命名空间工具声明会被检查,但不会将客户端函数视为内置搜索。在初始资金预留前,路由按顺序检查符合条件且已授权的候选者,并跳过未配置所需搜索计价的候选者。必要的渠道/提供商及连续性亲和性限制仍会强制执行。若没有允许的候选者具备计价覆盖,准入将在提供方派发或资金预留前返回 HTTP 503 search_tool_pricing_not_configured。每个实际的故障回退及供应层级候选者都会在派发前再次检查;缺失计价绝不消耗提供方尝试次数。对于企业后付费请求,结算前将根据剩余授权预算检查超出初始估算的实际提供方用量。预算拒绝会保留已记录的用量和价格以供核对。客户端函数工具不受影响。 原生请求保留提供方参数,但须符合所选模型的官方支持。跨协议请求通过请求中间表示(IR)映射受支持的内容和控制。未映射的扩展和近似控制记录在转换诊断中,而不会拒绝其他可用的请求。畸形的源内容仍返回 HTTP 400。无法表示的跨协议工具声明会在资金准入前返回 HTTP 400,而不会被静默丢弃;符合条件的原生路由可保留原生专属工具。Anthropic stop_sequences 映射到 Chat 的 stop;不会伪造上游未报告的匹配序列。使用 Responses previous_response_id/conversation、Anthropic thread 或 Gemini cachedContent 的请求需要其服务端状态。即使输入包含重复的历史记录,这些引用也绝不会被丢弃。路由会排除无法保留状态的转换,并优先选择符合条件的原生路由;状态归属仍取决于原始服务商/账户以及现有的连续性亲和性检查。如果所有候选均因此原因被排除,则在服务商派发前返回 HTTP 422 conversation_state_unavailable。网关当前不会物化引用的历史。仅原生协议可用性并不能证明所选账户中存在私有状态 ID。回退不会自动将 json_schema 降级为 json_object。 配置支持时,Chat Completions、Responses、Anthropic Messages 和 Gemini generateContent 可使用 model=auto 或 auto-cn。在特征打分之前,智能路由会过滤原生 json_schema/json_object 支持、显式关闭思考支持、完整输入长度加上请求的输出预留以及所需的输入模态。文本上下文长度包括完整的系统/历史/工具定义及结果和 JSON 结构,在分词器集成前按每个预估文本 token 对应一个 UTF-16 字符计算。在此预估中,显式媒体传输载荷会被替换为类型占位符;Base64 长度不是媒体 token 计数。实际媒体 token 用量和限制仍取决于特定服务商并在上游校验。JSON 和思考关闭支持来自已发布的 llm_capabilities(jsonSchema、jsonObject、reasoning、reasoningDisable);缺失的硬能力事实不视为支持。无推理能力的模型满足思考关闭。推理强度、摘要详细度、隐藏思考和可选输出元数据不作为候选者过滤条件。配置 Redis 时,Auto 首先检查租户、API 密钥、路由模式和协议范围内的显式客户端会话绑定,然后检查历史指纹。会话提取优先采用 X-Claude-Code-Session-Id、X-OpenCode-Session-Id、X-DeepSeek-Harness-Session-Id、X-QwenWork-Session-Id 和 thread-id,其次是 Responses client_metadata session_id/thread_id 以及 JSON x-codex-turn-metadata 中的相同字段。通用的 X-Session-Id、session_id、session-id、X-Cursor-Session 和 X-OpenClaw-Session-Id 紧随其后,接着是请求体中的 session_id、sessionId、metadata.session_id 和 metadata.sessionId。Anthropic 还接受 JSON metadata.user_id 内部的 session_id。X-Task-ID、X-OpenCode-Session 和 X-Session-Affinity 仅作为回退标识。KimiCLI/ User-Agent 还会额外启用已知的 Chat Completions prompt_cache_key 或 Anthropic 纯文本 metadata.user_id 会话惯例。缺失或畸形的标识符不会导致请求被拒绝。用户/账户、请求、提示词、轮次及父级标识符不会被全局视为会话 ID。会话查找失败仍会尝试历史匹配;两种绑定仅在成功完成时更新。History v2 排除非消息角色/控制项和不完整的工具调用标识符;没有 User 边界意味着包含所有可用历史。有效命中会在重新检查当前候选者资格后跳过 Jev 打分及其路由费用;若该绑定模型失败,Auto 将绕过绑定并评分一次以填充剩余的不同模型尝试。未命中和缓存失败使用正常评分。绑定在 24 小时后过期,且仅在成功的 JSON 或完整的 SSE 响应后写入;取消、未完成、模糊或过大的流不会创建绑定。智能路由对 API 密钥和协议允许的剩余当前网关目录模型进行评分,然后选定的具体模型遵循现有的权限、渠道路由和计费规则。对于 auto/auto-cn,来自 Chat Completions、Responses 和 Anthropic 的 Vertex Gemini 文本请求使用 Vertex 兼容 OpenAI 的 Chat 端点,采用相同的账户、模型和已发布的 Gemini 资费。Chat 消息/工具载荷予以保留;Responses 和 Anthropic 仅转换为 Chat。包含视频的 Auto 请求保留原生 Gemini generateContent/streamGenerateContent 转换,因为 Vertex Chat 拒绝 video_url;媒体字节、混合音频、账户和 Gemini 计价予以保留。显式模型请求和原生 Gemini/媒体路径保留其现有路由。价格和上下文限制来自当前已发布的目录;缺失的上下文限制可使用版本化能力快照并记录日志。可选能力覆盖不定义候选列表。任务特征失败记录为降级并使用中性需求值。配置或打分凭证缺失、目录无效或无符合条件的模型返回 HTTP 503(auto_routing_not_configured、auto_routing_configuration_invalid、auto_routing_scorer_unavailable、auto_routing_no_candidates)。选择失败返回 auto_routing_failed。对于 Responses 历史,仅消息项(包括省略 type)需要 role;非消息项保留在完整上游请求中,不参与评分。Jev 仅接收用户/助手文本及最多 500 个加权字符的系统前缀;工具定义、调用/结果和其他角色均排除。评分前检查完整请求中的图像、音频、视频及文件内容块。已发布模型的输入模态必须覆盖所有附件类型,选中及回退渠道也必须在 metadata.input_modalities(亦接受 inputModalities)中显式声明这些类型;不兼容渠道在派发前返回 capability_mismatch。未知 MIME 类型和不透明文件引用要求文件支持。媒体字节、URL 和文件 ID 从 Jev 材料中排除,替换为附件类型占位符;原始请求保持不变。不引入多模态需求特征或能力评分。非文本输出、生图工具和服务端存储的 Responses 连续会话仍需要显式模型,返回 HTTP 400 auto_routing_request_unsupported。在每次模型尝试不成功后,Auto 会尝试下一个排名的模型,包括任何非 2xx 响应、通用 HTTP 400 校验错误、服务商拒绝、5xx、超时、传输错误和未分类的本地执行失败。失败分类和不确定的服务商费用不会阻止回退。每次尝试都保留自己的结算凭据;重试不会将不确定的服务商结果转换为已确认的零费用。一次特征评估最多尝试三个不同的已排名模型。每次尝试在独立的执行 ID 下重复现有的授权、配额、速率限制、路由和资金检查。公开的 X-Request-Id 保持稳定;执行记录和计费元数据保留其关联。客户端取消或成功交付响应将停止跨模型回退。已交付给客户端的流不会重新启动。每个候选者仍必须通过授权和资金检查;未通过的检查绝不会授权上游外发。当所有候选者均失败时,将返回最终尝试的错误。显式模型请求不使用此回退。在需要 Jev 评分的最终模型执行成功后,Auto 会在公开父请求 ID 上追加一次平台路由费用:min(20 * L / 1000000 + 0.01505, 0.2) 积分,其中 L 是压缩后 Jev 状态的 UTF-16 字符串长度(对象的 JSON 序列化),在各次打分调用中统一计量一次。1 美元等于 100 积分;费用四舍五入到微美元(0.0001 积分)。失败或不完整的流以及失败的最终执行不产生此费用。计费模式为 auto,包括 auto-cn 请求。公开 Auto 请求 ID 的请求费用查询包含其路由费和所有已结算子执行费用。
POST /gemini/v1beta/models/{model}:streamGenerateContent请求示例
curl \
--request POST \
--url 'https://api.anyint.ai/gemini/v1beta/models/<model>:streamGenerateContent' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: text/event-stream' \
--header 'Content-Type: application/json' \
--data '{
"contents": [
{
"parts": [
{
"text": "Explain edge computing briefly."
}
]
}
]
}'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| model | path | string | 必填 | — |
| alt | query | string | 可选 | — |
| X-Client-Message-Id | header | string | 可选 | 启用租户范围的持久执行去重。只能使用相同请求体和 API 密钥重用消息 ID。已完成或可能已经派发的请求不会因到期或 Redis 数据丢失而再次执行。派发后即使上游报错或结算回滚,也须使用新消息 ID 发起另一次执行;派发前失败可使用原 ID 重试。 |
| X-Resume-Message-Id | header | string | 可选 | 使用原 API 密钥和相同请求体重放已生成的 SSE 流,不会再次调用上游或计费。缓存保留 10 分钟,输出总量上限为 4 MiB;中断后的续写须使用新的消息 ID。 |
| X-Resume-From-Offset | header | integer | 可选 | 已接收的完整 SSE 事件数,与最后一个 SSE id 一致,从 0 开始;单位不是 UTF-8 字节、令牌或字符。优先于 Last-Event-ID。 |
| Last-Event-ID | header | integer | 可选 | 未提供 X-Resume-From-Offset 时使用的完整 SSE 事件偏移量。 |
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
请求体
必填{
"contents": [
{
"parts": [
{
"text": "Explain edge computing briefly."
}
]
}
]
}响应
data: {"candidates":[{"content":{"role":"model","parts":[{"text":"Edge computing reduces latency."}]}}]}
Gemini Developer API 上的 Gemini 4 Argon 仅支持 Standard 推理。请省略 serviceTier/service_tier 或将其设为 standard;其他取值会在外发上游前返回 HTTP 400。 启用计费时,tools 或 Responses input.additional_tools 中声明的内置网络搜索要求已编译的价格规则覆盖 web_search_queries 及对应请求维度。命名空间工具声明会被检查,但不会将客户端函数视为内置搜索。在初始资金预留前,路由按顺序检查符合条件且已授权的候选者,并跳过未配置所需搜索计价的候选者。必要的渠道/提供商及连续性亲和性限制仍会强制执行。若没有允许的候选者具备计价覆盖,准入将在提供方派发或资金预留前返回 HTTP 503 search_tool_pricing_not_configured。每个实际的故障回退及供应层级候选者都会在派发前再次检查;缺失计价绝不消耗提供方尝试次数。对于企业后付费请求,结算前将根据剩余授权预算检查超出初始估算的实际提供方用量。预算拒绝会保留已记录的用量和价格以供核对。客户端函数工具不受影响。 原生请求保留提供方参数,但须符合所选模型的官方支持。跨协议请求通过请求中间表示(IR)映射受支持的内容和控制。未映射的扩展和近似控制记录在转换诊断中,而不会拒绝其他可用的请求。畸形的源内容仍返回 HTTP 400。无法表示的跨协议工具声明会在资金准入前返回 HTTP 400,而不会被静默丢弃;符合条件的原生路由可保留原生专属工具。Anthropic stop_sequences 映射到 Chat 的 stop;不会伪造上游未报告的匹配序列。使用 Responses previous_response_id/conversation、Anthropic thread 或 Gemini cachedContent 的请求需要其服务端状态。即使输入包含重复的历史记录,这些引用也绝不会被丢弃。路由会排除无法保留状态的转换,并优先选择符合条件的原生路由;状态归属仍取决于原始服务商/账户以及现有的连续性亲和性检查。如果所有候选均因此原因被排除,则在服务商派发前返回 HTTP 422 conversation_state_unavailable。网关当前不会物化引用的历史。仅原生协议可用性并不能证明所选账户中存在私有状态 ID。回退不会自动将 json_schema 降级为 json_object。 配置支持时,Chat Completions、Responses、Anthropic Messages 和 Gemini generateContent 可使用 model=auto 或 auto-cn。在特征打分之前,智能路由会过滤原生 json_schema/json_object 支持、显式关闭思考支持、完整输入长度加上请求的输出预留以及所需的输入模态。文本上下文长度包括完整的系统/历史/工具定义及结果和 JSON 结构,在分词器集成前按每个预估文本 token 对应一个 UTF-16 字符计算。在此预估中,显式媒体传输载荷会被替换为类型占位符;Base64 长度不是媒体 token 计数。实际媒体 token 用量和限制仍取决于特定服务商并在上游校验。JSON 和思考关闭支持来自已发布的 llm_capabilities(jsonSchema、jsonObject、reasoning、reasoningDisable);缺失的硬能力事实不视为支持。无推理能力的模型满足思考关闭。推理强度、摘要详细度、隐藏思考和可选输出元数据不作为候选者过滤条件。配置 Redis 时,Auto 首先检查租户、API 密钥、路由模式和协议范围内的显式客户端会话绑定,然后检查历史指纹。会话提取优先采用 X-Claude-Code-Session-Id、X-OpenCode-Session-Id、X-DeepSeek-Harness-Session-Id、X-QwenWork-Session-Id 和 thread-id,其次是 Responses client_metadata session_id/thread_id 以及 JSON x-codex-turn-metadata 中的相同字段。通用的 X-Session-Id、session_id、session-id、X-Cursor-Session 和 X-OpenClaw-Session-Id 紧随其后,接着是请求体中的 session_id、sessionId、metadata.session_id 和 metadata.sessionId。Anthropic 还接受 JSON metadata.user_id 内部的 session_id。X-Task-ID、X-OpenCode-Session 和 X-Session-Affinity 仅作为回退标识。KimiCLI/ User-Agent 还会额外启用已知的 Chat Completions prompt_cache_key 或 Anthropic 纯文本 metadata.user_id 会话惯例。缺失或畸形的标识符不会导致请求被拒绝。用户/账户、请求、提示词、轮次及父级标识符不会被全局视为会话 ID。会话查找失败仍会尝试历史匹配;两种绑定仅在成功完成时更新。History v2 排除非消息角色/控制项和不完整的工具调用标识符;没有 User 边界意味着包含所有可用历史。有效命中会在重新检查当前候选者资格后跳过 Jev 打分及其路由费用;若该绑定模型失败,Auto 将绕过绑定并评分一次以填充剩余的不同模型尝试。未命中和缓存失败使用正常评分。绑定在 24 小时后过期,且仅在成功的 JSON 或完整的 SSE 响应后写入;取消、未完成、模糊或过大的流不会创建绑定。智能路由对 API 密钥和协议允许的剩余当前网关目录模型进行评分,然后选定的具体模型遵循现有的权限、渠道路由和计费规则。对于 auto/auto-cn,来自 Chat Completions、Responses 和 Anthropic 的 Vertex Gemini 文本请求使用 Vertex 兼容 OpenAI 的 Chat 端点,采用相同的账户、模型和已发布的 Gemini 资费。Chat 消息/工具载荷予以保留;Responses 和 Anthropic 仅转换为 Chat。包含视频的 Auto 请求保留原生 Gemini generateContent/streamGenerateContent 转换,因为 Vertex Chat 拒绝 video_url;媒体字节、混合音频、账户和 Gemini 计价予以保留。显式模型请求和原生 Gemini/媒体路径保留其现有路由。价格和上下文限制来自当前已发布的目录;缺失的上下文限制可使用版本化能力快照并记录日志。可选能力覆盖不定义候选列表。任务特征失败记录为降级并使用中性需求值。配置或打分凭证缺失、目录无效或无符合条件的模型返回 HTTP 503(auto_routing_not_configured、auto_routing_configuration_invalid、auto_routing_scorer_unavailable、auto_routing_no_candidates)。选择失败返回 auto_routing_failed。对于 Responses 历史,仅消息项(包括省略 type)需要 role;非消息项保留在完整上游请求中,不参与评分。Jev 仅接收用户/助手文本及最多 500 个加权字符的系统前缀;工具定义、调用/结果和其他角色均排除。评分前检查完整请求中的图像、音频、视频及文件内容块。已发布模型的输入模态必须覆盖所有附件类型,选中及回退渠道也必须在 metadata.input_modalities(亦接受 inputModalities)中显式声明这些类型;不兼容渠道在派发前返回 capability_mismatch。未知 MIME 类型和不透明文件引用要求文件支持。媒体字节、URL 和文件 ID 从 Jev 材料中排除,替换为附件类型占位符;原始请求保持不变。不引入多模态需求特征或能力评分。非文本输出、生图工具和服务端存储的 Responses 连续会话仍需要显式模型,返回 HTTP 400 auto_routing_request_unsupported。在每次模型尝试不成功后,Auto 会尝试下一个排名的模型,包括任何非 2xx 响应、通用 HTTP 400 校验错误、服务商拒绝、5xx、超时、传输错误和未分类的本地执行失败。失败分类和不确定的服务商费用不会阻止回退。每次尝试都保留自己的结算凭据;重试不会将不确定的服务商结果转换为已确认的零费用。一次特征评估最多尝试三个不同的已排名模型。每次尝试在独立的执行 ID 下重复现有的授权、配额、速率限制、路由和资金检查。公开的 X-Request-Id 保持稳定;执行记录和计费元数据保留其关联。客户端取消或成功交付响应将停止跨模型回退。已交付给客户端的流不会重新启动。每个候选者仍必须通过授权和资金检查;未通过的检查绝不会授权上游外发。当所有候选者均失败时,将返回最终尝试的错误。显式模型请求不使用此回退。在需要 Jev 评分的最终模型执行成功后,Auto 会在公开父请求 ID 上追加一次平台路由费用:min(20 * L / 1000000 + 0.01505, 0.2) 积分,其中 L 是压缩后 Jev 状态的 UTF-16 字符串长度(对象的 JSON 序列化),在各次打分调用中统一计量一次。1 美元等于 100 积分;费用四舍五入到微美元(0.0001 积分)。失败或不完整的流以及失败的最终执行不产生此费用。计费模式为 auto,包括 auto-cn 请求。公开 Auto 请求 ID 的请求费用查询包含其路由费和所有已结算子执行费用。
POST /gemini/v1beta/models/{model}/generateContent请求示例
curl \
--request POST \
--url 'https://api.anyint.ai/gemini/v1beta/models/<model>/generateContent' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"contents": [
{
"parts": [
{
"text": "Explain edge computing briefly."
}
]
}
]
}'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| model | path | string | 必填 | — |
| X-Client-Message-Id | header | string | 可选 | 启用租户范围的持久执行去重。只能使用相同请求体和 API 密钥重用消息 ID。已完成或可能已经派发的请求不会因到期或 Redis 数据丢失而再次执行。派发后即使上游报错或结算回滚,也须使用新消息 ID 发起另一次执行;派发前失败可使用原 ID 重试。 |
| X-Resume-Message-Id | header | string | 可选 | 使用原 API 密钥和相同请求体重放已生成的 SSE 流,不会再次调用上游或计费。缓存保留 10 分钟,输出总量上限为 4 MiB;中断后的续写须使用新的消息 ID。 |
| X-Resume-From-Offset | header | integer | 可选 | 已接收的完整 SSE 事件数,与最后一个 SSE id 一致,从 0 开始;单位不是 UTF-8 字节、令牌或字符。优先于 Last-Event-ID。 |
| Last-Event-ID | header | integer | 可选 | 未提供 X-Resume-From-Offset 时使用的完整 SSE 事件偏移量。 |
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
请求体
必填{
"contents": [
{
"parts": [
{
"text": "Explain edge computing briefly."
}
]
}
]
}响应
{
"candidates": [
{
"content": {
"role": "model",
"parts": [
{
"text": "Edge computing reduces latency."
}
]
}
}
]
}Gemini Developer API 上的 Gemini 4 Argon 仅支持 Standard 推理。请省略 serviceTier/service_tier 或将其设为 standard;其他取值会在外发上游前返回 HTTP 400。 启用计费时,tools 或 Responses input.additional_tools 中声明的内置网络搜索要求已编译的价格规则覆盖 web_search_queries 及对应请求维度。命名空间工具声明会被检查,但不会将客户端函数视为内置搜索。在初始资金预留前,路由按顺序检查符合条件且已授权的候选者,并跳过未配置所需搜索计价的候选者。必要的渠道/提供商及连续性亲和性限制仍会强制执行。若没有允许的候选者具备计价覆盖,准入将在提供方派发或资金预留前返回 HTTP 503 search_tool_pricing_not_configured。每个实际的故障回退及供应层级候选者都会在派发前再次检查;缺失计价绝不消耗提供方尝试次数。对于企业后付费请求,结算前将根据剩余授权预算检查超出初始估算的实际提供方用量。预算拒绝会保留已记录的用量和价格以供核对。客户端函数工具不受影响。 原生请求保留提供方参数,但须符合所选模型的官方支持。跨协议请求通过请求中间表示(IR)映射受支持的内容和控制。未映射的扩展和近似控制记录在转换诊断中,而不会拒绝其他可用的请求。畸形的源内容仍返回 HTTP 400。无法表示的跨协议工具声明会在资金准入前返回 HTTP 400,而不会被静默丢弃;符合条件的原生路由可保留原生专属工具。Anthropic stop_sequences 映射到 Chat 的 stop;不会伪造上游未报告的匹配序列。使用 Responses previous_response_id/conversation、Anthropic thread 或 Gemini cachedContent 的请求需要其服务端状态。即使输入包含重复的历史记录,这些引用也绝不会被丢弃。路由会排除无法保留状态的转换,并优先选择符合条件的原生路由;状态归属仍取决于原始服务商/账户以及现有的连续性亲和性检查。如果所有候选均因此原因被排除,则在服务商派发前返回 HTTP 422 conversation_state_unavailable。网关当前不会物化引用的历史。仅原生协议可用性并不能证明所选账户中存在私有状态 ID。回退不会自动将 json_schema 降级为 json_object。 配置支持时,Chat Completions、Responses、Anthropic Messages 和 Gemini generateContent 可使用 model=auto 或 auto-cn。在特征打分之前,智能路由会过滤原生 json_schema/json_object 支持、显式关闭思考支持、完整输入长度加上请求的输出预留以及所需的输入模态。文本上下文长度包括完整的系统/历史/工具定义及结果和 JSON 结构,在分词器集成前按每个预估文本 token 对应一个 UTF-16 字符计算。在此预估中,显式媒体传输载荷会被替换为类型占位符;Base64 长度不是媒体 token 计数。实际媒体 token 用量和限制仍取决于特定服务商并在上游校验。JSON 和思考关闭支持来自已发布的 llm_capabilities(jsonSchema、jsonObject、reasoning、reasoningDisable);缺失的硬能力事实不视为支持。无推理能力的模型满足思考关闭。推理强度、摘要详细度、隐藏思考和可选输出元数据不作为候选者过滤条件。配置 Redis 时,Auto 首先检查租户、API 密钥、路由模式和协议范围内的显式客户端会话绑定,然后检查历史指纹。会话提取优先采用 X-Claude-Code-Session-Id、X-OpenCode-Session-Id、X-DeepSeek-Harness-Session-Id、X-QwenWork-Session-Id 和 thread-id,其次是 Responses client_metadata session_id/thread_id 以及 JSON x-codex-turn-metadata 中的相同字段。通用的 X-Session-Id、session_id、session-id、X-Cursor-Session 和 X-OpenClaw-Session-Id 紧随其后,接着是请求体中的 session_id、sessionId、metadata.session_id 和 metadata.sessionId。Anthropic 还接受 JSON metadata.user_id 内部的 session_id。X-Task-ID、X-OpenCode-Session 和 X-Session-Affinity 仅作为回退标识。KimiCLI/ User-Agent 还会额外启用已知的 Chat Completions prompt_cache_key 或 Anthropic 纯文本 metadata.user_id 会话惯例。缺失或畸形的标识符不会导致请求被拒绝。用户/账户、请求、提示词、轮次及父级标识符不会被全局视为会话 ID。会话查找失败仍会尝试历史匹配;两种绑定仅在成功完成时更新。History v2 排除非消息角色/控制项和不完整的工具调用标识符;没有 User 边界意味着包含所有可用历史。有效命中会在重新检查当前候选者资格后跳过 Jev 打分及其路由费用;若该绑定模型失败,Auto 将绕过绑定并评分一次以填充剩余的不同模型尝试。未命中和缓存失败使用正常评分。绑定在 24 小时后过期,且仅在成功的 JSON 或完整的 SSE 响应后写入;取消、未完成、模糊或过大的流不会创建绑定。智能路由对 API 密钥和协议允许的剩余当前网关目录模型进行评分,然后选定的具体模型遵循现有的权限、渠道路由和计费规则。对于 auto/auto-cn,来自 Chat Completions、Responses 和 Anthropic 的 Vertex Gemini 文本请求使用 Vertex 兼容 OpenAI 的 Chat 端点,采用相同的账户、模型和已发布的 Gemini 资费。Chat 消息/工具载荷予以保留;Responses 和 Anthropic 仅转换为 Chat。包含视频的 Auto 请求保留原生 Gemini generateContent/streamGenerateContent 转换,因为 Vertex Chat 拒绝 video_url;媒体字节、混合音频、账户和 Gemini 计价予以保留。显式模型请求和原生 Gemini/媒体路径保留其现有路由。价格和上下文限制来自当前已发布的目录;缺失的上下文限制可使用版本化能力快照并记录日志。可选能力覆盖不定义候选列表。任务特征失败记录为降级并使用中性需求值。配置或打分凭证缺失、目录无效或无符合条件的模型返回 HTTP 503(auto_routing_not_configured、auto_routing_configuration_invalid、auto_routing_scorer_unavailable、auto_routing_no_candidates)。选择失败返回 auto_routing_failed。对于 Responses 历史,仅消息项(包括省略 type)需要 role;非消息项保留在完整上游请求中,不参与评分。Jev 仅接收用户/助手文本及最多 500 个加权字符的系统前缀;工具定义、调用/结果和其他角色均排除。评分前检查完整请求中的图像、音频、视频及文件内容块。已发布模型的输入模态必须覆盖所有附件类型,选中及回退渠道也必须在 metadata.input_modalities(亦接受 inputModalities)中显式声明这些类型;不兼容渠道在派发前返回 capability_mismatch。未知 MIME 类型和不透明文件引用要求文件支持。媒体字节、URL 和文件 ID 从 Jev 材料中排除,替换为附件类型占位符;原始请求保持不变。不引入多模态需求特征或能力评分。非文本输出、生图工具和服务端存储的 Responses 连续会话仍需要显式模型,返回 HTTP 400 auto_routing_request_unsupported。在每次模型尝试不成功后,Auto 会尝试下一个排名的模型,包括任何非 2xx 响应、通用 HTTP 400 校验错误、服务商拒绝、5xx、超时、传输错误和未分类的本地执行失败。失败分类和不确定的服务商费用不会阻止回退。每次尝试都保留自己的结算凭据;重试不会将不确定的服务商结果转换为已确认的零费用。一次特征评估最多尝试三个不同的已排名模型。每次尝试在独立的执行 ID 下重复现有的授权、配额、速率限制、路由和资金检查。公开的 X-Request-Id 保持稳定;执行记录和计费元数据保留其关联。客户端取消或成功交付响应将停止跨模型回退。已交付给客户端的流不会重新启动。每个候选者仍必须通过授权和资金检查;未通过的检查绝不会授权上游外发。当所有候选者均失败时,将返回最终尝试的错误。显式模型请求不使用此回退。在需要 Jev 评分的最终模型执行成功后,Auto 会在公开父请求 ID 上追加一次平台路由费用:min(20 * L / 1000000 + 0.01505, 0.2) 积分,其中 L 是压缩后 Jev 状态的 UTF-16 字符串长度(对象的 JSON 序列化),在各次打分调用中统一计量一次。1 美元等于 100 积分;费用四舍五入到微美元(0.0001 积分)。失败或不完整的流以及失败的最终执行不产生此费用。计费模式为 auto,包括 auto-cn 请求。公开 Auto 请求 ID 的请求费用查询包含其路由费和所有已结算子执行费用。
POST /gemini/v1beta/models/{model}/streamGenerateContent请求示例
curl \
--request POST \
--url 'https://api.anyint.ai/gemini/v1beta/models/<model>/streamGenerateContent' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: text/event-stream' \
--header 'Content-Type: application/json' \
--data '{
"contents": [
{
"parts": [
{
"text": "Explain edge computing briefly."
}
]
}
]
}'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| model | path | string | 必填 | — |
| alt | query | string | 可选 | — |
| X-Client-Message-Id | header | string | 可选 | 启用租户范围的持久执行去重。只能使用相同请求体和 API 密钥重用消息 ID。已完成或可能已经派发的请求不会因到期或 Redis 数据丢失而再次执行。派发后即使上游报错或结算回滚,也须使用新消息 ID 发起另一次执行;派发前失败可使用原 ID 重试。 |
| X-Resume-Message-Id | header | string | 可选 | 使用原 API 密钥和相同请求体重放已生成的 SSE 流,不会再次调用上游或计费。缓存保留 10 分钟,输出总量上限为 4 MiB;中断后的续写须使用新的消息 ID。 |
| X-Resume-From-Offset | header | integer | 可选 | 已接收的完整 SSE 事件数,与最后一个 SSE id 一致,从 0 开始;单位不是 UTF-8 字节、令牌或字符。优先于 Last-Event-ID。 |
| Last-Event-ID | header | integer | 可选 | 未提供 X-Resume-From-Offset 时使用的完整 SSE 事件偏移量。 |
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
请求体
必填{
"contents": [
{
"parts": [
{
"text": "Explain edge computing briefly."
}
]
}
]
}响应
data: {"candidates":[{"content":{"role":"model","parts":[{"text":"Edge computing reduces latency."}]}}]}
Gemini Developer API 上的 Gemini 4 Argon 仅支持 Standard 推理。请省略 serviceTier/service_tier 或将其设为 standard;其他取值会在外发上游前返回 HTTP 400。 启用计费时,tools 或 Responses input.additional_tools 中声明的内置网络搜索要求已编译的价格规则覆盖 web_search_queries 及对应请求维度。命名空间工具声明会被检查,但不会将客户端函数视为内置搜索。在初始资金预留前,路由按顺序检查符合条件且已授权的候选者,并跳过未配置所需搜索计价的候选者。必要的渠道/提供商及连续性亲和性限制仍会强制执行。若没有允许的候选者具备计价覆盖,准入将在提供方派发或资金预留前返回 HTTP 503 search_tool_pricing_not_configured。每个实际的故障回退及供应层级候选者都会在派发前再次检查;缺失计价绝不消耗提供方尝试次数。对于企业后付费请求,结算前将根据剩余授权预算检查超出初始估算的实际提供方用量。预算拒绝会保留已记录的用量和价格以供核对。客户端函数工具不受影响。 原生请求保留提供方参数,但须符合所选模型的官方支持。跨协议请求通过请求中间表示(IR)映射受支持的内容和控制。未映射的扩展和近似控制记录在转换诊断中,而不会拒绝其他可用的请求。畸形的源内容仍返回 HTTP 400。无法表示的跨协议工具声明会在资金准入前返回 HTTP 400,而不会被静默丢弃;符合条件的原生路由可保留原生专属工具。Anthropic stop_sequences 映射到 Chat 的 stop;不会伪造上游未报告的匹配序列。使用 Responses previous_response_id/conversation、Anthropic thread 或 Gemini cachedContent 的请求需要其服务端状态。即使输入包含重复的历史记录,这些引用也绝不会被丢弃。路由会排除无法保留状态的转换,并优先选择符合条件的原生路由;状态归属仍取决于原始服务商/账户以及现有的连续性亲和性检查。如果所有候选均因此原因被排除,则在服务商派发前返回 HTTP 422 conversation_state_unavailable。网关当前不会物化引用的历史。仅原生协议可用性并不能证明所选账户中存在私有状态 ID。回退不会自动将 json_schema 降级为 json_object。 配置支持时,Chat Completions、Responses、Anthropic Messages 和 Gemini generateContent 可使用 model=auto 或 auto-cn。在特征打分之前,智能路由会过滤原生 json_schema/json_object 支持、显式关闭思考支持、完整输入长度加上请求的输出预留以及所需的输入模态。文本上下文长度包括完整的系统/历史/工具定义及结果和 JSON 结构,在分词器集成前按每个预估文本 token 对应一个 UTF-16 字符计算。在此预估中,显式媒体传输载荷会被替换为类型占位符;Base64 长度不是媒体 token 计数。实际媒体 token 用量和限制仍取决于特定服务商并在上游校验。JSON 和思考关闭支持来自已发布的 llm_capabilities(jsonSchema、jsonObject、reasoning、reasoningDisable);缺失的硬能力事实不视为支持。无推理能力的模型满足思考关闭。推理强度、摘要详细度、隐藏思考和可选输出元数据不作为候选者过滤条件。配置 Redis 时,Auto 首先检查租户、API 密钥、路由模式和协议范围内的显式客户端会话绑定,然后检查历史指纹。会话提取优先采用 X-Claude-Code-Session-Id、X-OpenCode-Session-Id、X-DeepSeek-Harness-Session-Id、X-QwenWork-Session-Id 和 thread-id,其次是 Responses client_metadata session_id/thread_id 以及 JSON x-codex-turn-metadata 中的相同字段。通用的 X-Session-Id、session_id、session-id、X-Cursor-Session 和 X-OpenClaw-Session-Id 紧随其后,接着是请求体中的 session_id、sessionId、metadata.session_id 和 metadata.sessionId。Anthropic 还接受 JSON metadata.user_id 内部的 session_id。X-Task-ID、X-OpenCode-Session 和 X-Session-Affinity 仅作为回退标识。KimiCLI/ User-Agent 还会额外启用已知的 Chat Completions prompt_cache_key 或 Anthropic 纯文本 metadata.user_id 会话惯例。缺失或畸形的标识符不会导致请求被拒绝。用户/账户、请求、提示词、轮次及父级标识符不会被全局视为会话 ID。会话查找失败仍会尝试历史匹配;两种绑定仅在成功完成时更新。History v2 排除非消息角色/控制项和不完整的工具调用标识符;没有 User 边界意味着包含所有可用历史。有效命中会在重新检查当前候选者资格后跳过 Jev 打分及其路由费用;若该绑定模型失败,Auto 将绕过绑定并评分一次以填充剩余的不同模型尝试。未命中和缓存失败使用正常评分。绑定在 24 小时后过期,且仅在成功的 JSON 或完整的 SSE 响应后写入;取消、未完成、模糊或过大的流不会创建绑定。智能路由对 API 密钥和协议允许的剩余当前网关目录模型进行评分,然后选定的具体模型遵循现有的权限、渠道路由和计费规则。对于 auto/auto-cn,来自 Chat Completions、Responses 和 Anthropic 的 Vertex Gemini 文本请求使用 Vertex 兼容 OpenAI 的 Chat 端点,采用相同的账户、模型和已发布的 Gemini 资费。Chat 消息/工具载荷予以保留;Responses 和 Anthropic 仅转换为 Chat。包含视频的 Auto 请求保留原生 Gemini generateContent/streamGenerateContent 转换,因为 Vertex Chat 拒绝 video_url;媒体字节、混合音频、账户和 Gemini 计价予以保留。显式模型请求和原生 Gemini/媒体路径保留其现有路由。价格和上下文限制来自当前已发布的目录;缺失的上下文限制可使用版本化能力快照并记录日志。可选能力覆盖不定义候选列表。任务特征失败记录为降级并使用中性需求值。配置或打分凭证缺失、目录无效或无符合条件的模型返回 HTTP 503(auto_routing_not_configured、auto_routing_configuration_invalid、auto_routing_scorer_unavailable、auto_routing_no_candidates)。选择失败返回 auto_routing_failed。对于 Responses 历史,仅消息项(包括省略 type)需要 role;非消息项保留在完整上游请求中,不参与评分。Jev 仅接收用户/助手文本及最多 500 个加权字符的系统前缀;工具定义、调用/结果和其他角色均排除。评分前检查完整请求中的图像、音频、视频及文件内容块。已发布模型的输入模态必须覆盖所有附件类型,选中及回退渠道也必须在 metadata.input_modalities(亦接受 inputModalities)中显式声明这些类型;不兼容渠道在派发前返回 capability_mismatch。未知 MIME 类型和不透明文件引用要求文件支持。媒体字节、URL 和文件 ID 从 Jev 材料中排除,替换为附件类型占位符;原始请求保持不变。不引入多模态需求特征或能力评分。非文本输出、生图工具和服务端存储的 Responses 连续会话仍需要显式模型,返回 HTTP 400 auto_routing_request_unsupported。在每次模型尝试不成功后,Auto 会尝试下一个排名的模型,包括任何非 2xx 响应、通用 HTTP 400 校验错误、服务商拒绝、5xx、超时、传输错误和未分类的本地执行失败。失败分类和不确定的服务商费用不会阻止回退。每次尝试都保留自己的结算凭据;重试不会将不确定的服务商结果转换为已确认的零费用。一次特征评估最多尝试三个不同的已排名模型。每次尝试在独立的执行 ID 下重复现有的授权、配额、速率限制、路由和资金检查。公开的 X-Request-Id 保持稳定;执行记录和计费元数据保留其关联。客户端取消或成功交付响应将停止跨模型回退。已交付给客户端的流不会重新启动。每个候选者仍必须通过授权和资金检查;未通过的检查绝不会授权上游外发。当所有候选者均失败时,将返回最终尝试的错误。显式模型请求不使用此回退。在需要 Jev 评分的最终模型执行成功后,Auto 会在公开父请求 ID 上追加一次平台路由费用:min(20 * L / 1000000 + 0.01505, 0.2) 积分,其中 L 是压缩后 Jev 状态的 UTF-16 字符串长度(对象的 JSON 序列化),在各次打分调用中统一计量一次。1 美元等于 100 积分;费用四舍五入到微美元(0.0001 积分)。失败或不完整的流以及失败的最终执行不产生此费用。计费模式为 auto,包括 auto-cn 请求。公开 Auto 请求 ID 的请求费用查询包含其路由费和所有已结算子执行费用。
POST /v1beta/models/{model}:generateContent请求示例
curl \
--request POST \
--url 'https://api.anyint.ai/v1beta/models/<model>:generateContent' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"contents": [
{
"parts": [
{
"text": "Explain edge computing briefly."
}
]
}
]
}'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| model | path | string | 必填 | — |
| X-Client-Message-Id | header | string | 可选 | 启用租户范围的持久执行去重。只能使用相同请求体和 API 密钥重用消息 ID。已完成或可能已经派发的请求不会因到期或 Redis 数据丢失而再次执行。派发后即使上游报错或结算回滚,也须使用新消息 ID 发起另一次执行;派发前失败可使用原 ID 重试。 |
| X-Resume-Message-Id | header | string | 可选 | 使用原 API 密钥和相同请求体重放已生成的 SSE 流,不会再次调用上游或计费。缓存保留 10 分钟,输出总量上限为 4 MiB;中断后的续写须使用新的消息 ID。 |
| X-Resume-From-Offset | header | integer | 可选 | 已接收的完整 SSE 事件数,与最后一个 SSE id 一致,从 0 开始;单位不是 UTF-8 字节、令牌或字符。优先于 Last-Event-ID。 |
| Last-Event-ID | header | integer | 可选 | 未提供 X-Resume-From-Offset 时使用的完整 SSE 事件偏移量。 |
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
请求体
必填{
"contents": [
{
"parts": [
{
"text": "Explain edge computing briefly."
}
]
}
]
}响应
{
"candidates": [
{
"content": {
"role": "model",
"parts": [
{
"text": "Edge computing reduces latency."
}
]
}
}
]
}Gemini Developer API 上的 Gemini 4 Argon 仅支持 Standard 推理。请省略 serviceTier/service_tier 或将其设为 standard;其他取值会在外发上游前返回 HTTP 400。 启用计费时,tools 或 Responses input.additional_tools 中声明的内置网络搜索要求已编译的价格规则覆盖 web_search_queries 及对应请求维度。命名空间工具声明会被检查,但不会将客户端函数视为内置搜索。在初始资金预留前,路由按顺序检查符合条件且已授权的候选者,并跳过未配置所需搜索计价的候选者。必要的渠道/提供商及连续性亲和性限制仍会强制执行。若没有允许的候选者具备计价覆盖,准入将在提供方派发或资金预留前返回 HTTP 503 search_tool_pricing_not_configured。每个实际的故障回退及供应层级候选者都会在派发前再次检查;缺失计价绝不消耗提供方尝试次数。对于企业后付费请求,结算前将根据剩余授权预算检查超出初始估算的实际提供方用量。预算拒绝会保留已记录的用量和价格以供核对。客户端函数工具不受影响。 原生请求保留提供方参数,但须符合所选模型的官方支持。跨协议请求通过请求中间表示(IR)映射受支持的内容和控制。未映射的扩展和近似控制记录在转换诊断中,而不会拒绝其他可用的请求。畸形的源内容仍返回 HTTP 400。无法表示的跨协议工具声明会在资金准入前返回 HTTP 400,而不会被静默丢弃;符合条件的原生路由可保留原生专属工具。Anthropic stop_sequences 映射到 Chat 的 stop;不会伪造上游未报告的匹配序列。使用 Responses previous_response_id/conversation、Anthropic thread 或 Gemini cachedContent 的请求需要其服务端状态。即使输入包含重复的历史记录,这些引用也绝不会被丢弃。路由会排除无法保留状态的转换,并优先选择符合条件的原生路由;状态归属仍取决于原始服务商/账户以及现有的连续性亲和性检查。如果所有候选均因此原因被排除,则在服务商派发前返回 HTTP 422 conversation_state_unavailable。网关当前不会物化引用的历史。仅原生协议可用性并不能证明所选账户中存在私有状态 ID。回退不会自动将 json_schema 降级为 json_object。 配置支持时,Chat Completions、Responses、Anthropic Messages 和 Gemini generateContent 可使用 model=auto 或 auto-cn。在特征打分之前,智能路由会过滤原生 json_schema/json_object 支持、显式关闭思考支持、完整输入长度加上请求的输出预留以及所需的输入模态。文本上下文长度包括完整的系统/历史/工具定义及结果和 JSON 结构,在分词器集成前按每个预估文本 token 对应一个 UTF-16 字符计算。在此预估中,显式媒体传输载荷会被替换为类型占位符;Base64 长度不是媒体 token 计数。实际媒体 token 用量和限制仍取决于特定服务商并在上游校验。JSON 和思考关闭支持来自已发布的 llm_capabilities(jsonSchema、jsonObject、reasoning、reasoningDisable);缺失的硬能力事实不视为支持。无推理能力的模型满足思考关闭。推理强度、摘要详细度、隐藏思考和可选输出元数据不作为候选者过滤条件。配置 Redis 时,Auto 首先检查租户、API 密钥、路由模式和协议范围内的显式客户端会话绑定,然后检查历史指纹。会话提取优先采用 X-Claude-Code-Session-Id、X-OpenCode-Session-Id、X-DeepSeek-Harness-Session-Id、X-QwenWork-Session-Id 和 thread-id,其次是 Responses client_metadata session_id/thread_id 以及 JSON x-codex-turn-metadata 中的相同字段。通用的 X-Session-Id、session_id、session-id、X-Cursor-Session 和 X-OpenClaw-Session-Id 紧随其后,接着是请求体中的 session_id、sessionId、metadata.session_id 和 metadata.sessionId。Anthropic 还接受 JSON metadata.user_id 内部的 session_id。X-Task-ID、X-OpenCode-Session 和 X-Session-Affinity 仅作为回退标识。KimiCLI/ User-Agent 还会额外启用已知的 Chat Completions prompt_cache_key 或 Anthropic 纯文本 metadata.user_id 会话惯例。缺失或畸形的标识符不会导致请求被拒绝。用户/账户、请求、提示词、轮次及父级标识符不会被全局视为会话 ID。会话查找失败仍会尝试历史匹配;两种绑定仅在成功完成时更新。History v2 排除非消息角色/控制项和不完整的工具调用标识符;没有 User 边界意味着包含所有可用历史。有效命中会在重新检查当前候选者资格后跳过 Jev 打分及其路由费用;若该绑定模型失败,Auto 将绕过绑定并评分一次以填充剩余的不同模型尝试。未命中和缓存失败使用正常评分。绑定在 24 小时后过期,且仅在成功的 JSON 或完整的 SSE 响应后写入;取消、未完成、模糊或过大的流不会创建绑定。智能路由对 API 密钥和协议允许的剩余当前网关目录模型进行评分,然后选定的具体模型遵循现有的权限、渠道路由和计费规则。对于 auto/auto-cn,来自 Chat Completions、Responses 和 Anthropic 的 Vertex Gemini 文本请求使用 Vertex 兼容 OpenAI 的 Chat 端点,采用相同的账户、模型和已发布的 Gemini 资费。Chat 消息/工具载荷予以保留;Responses 和 Anthropic 仅转换为 Chat。包含视频的 Auto 请求保留原生 Gemini generateContent/streamGenerateContent 转换,因为 Vertex Chat 拒绝 video_url;媒体字节、混合音频、账户和 Gemini 计价予以保留。显式模型请求和原生 Gemini/媒体路径保留其现有路由。价格和上下文限制来自当前已发布的目录;缺失的上下文限制可使用版本化能力快照并记录日志。可选能力覆盖不定义候选列表。任务特征失败记录为降级并使用中性需求值。配置或打分凭证缺失、目录无效或无符合条件的模型返回 HTTP 503(auto_routing_not_configured、auto_routing_configuration_invalid、auto_routing_scorer_unavailable、auto_routing_no_candidates)。选择失败返回 auto_routing_failed。对于 Responses 历史,仅消息项(包括省略 type)需要 role;非消息项保留在完整上游请求中,不参与评分。Jev 仅接收用户/助手文本及最多 500 个加权字符的系统前缀;工具定义、调用/结果和其他角色均排除。评分前检查完整请求中的图像、音频、视频及文件内容块。已发布模型的输入模态必须覆盖所有附件类型,选中及回退渠道也必须在 metadata.input_modalities(亦接受 inputModalities)中显式声明这些类型;不兼容渠道在派发前返回 capability_mismatch。未知 MIME 类型和不透明文件引用要求文件支持。媒体字节、URL 和文件 ID 从 Jev 材料中排除,替换为附件类型占位符;原始请求保持不变。不引入多模态需求特征或能力评分。非文本输出、生图工具和服务端存储的 Responses 连续会话仍需要显式模型,返回 HTTP 400 auto_routing_request_unsupported。在每次模型尝试不成功后,Auto 会尝试下一个排名的模型,包括任何非 2xx 响应、通用 HTTP 400 校验错误、服务商拒绝、5xx、超时、传输错误和未分类的本地执行失败。失败分类和不确定的服务商费用不会阻止回退。每次尝试都保留自己的结算凭据;重试不会将不确定的服务商结果转换为已确认的零费用。一次特征评估最多尝试三个不同的已排名模型。每次尝试在独立的执行 ID 下重复现有的授权、配额、速率限制、路由和资金检查。公开的 X-Request-Id 保持稳定;执行记录和计费元数据保留其关联。客户端取消或成功交付响应将停止跨模型回退。已交付给客户端的流不会重新启动。每个候选者仍必须通过授权和资金检查;未通过的检查绝不会授权上游外发。当所有候选者均失败时,将返回最终尝试的错误。显式模型请求不使用此回退。在需要 Jev 评分的最终模型执行成功后,Auto 会在公开父请求 ID 上追加一次平台路由费用:min(20 * L / 1000000 + 0.01505, 0.2) 积分,其中 L 是压缩后 Jev 状态的 UTF-16 字符串长度(对象的 JSON 序列化),在各次打分调用中统一计量一次。1 美元等于 100 积分;费用四舍五入到微美元(0.0001 积分)。失败或不完整的流以及失败的最终执行不产生此费用。计费模式为 auto,包括 auto-cn 请求。公开 Auto 请求 ID 的请求费用查询包含其路由费和所有已结算子执行费用。
POST /v1beta/models/{model}:streamGenerateContent请求示例
curl \
--request POST \
--url 'https://api.anyint.ai/v1beta/models/<model>:streamGenerateContent' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: text/event-stream' \
--header 'Content-Type: application/json' \
--data '{
"contents": [
{
"parts": [
{
"text": "Explain edge computing briefly."
}
]
}
]
}'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| model | path | string | 必填 | — |
| alt | query | string | 可选 | — |
| X-Client-Message-Id | header | string | 可选 | 启用租户范围的持久执行去重。只能使用相同请求体和 API 密钥重用消息 ID。已完成或可能已经派发的请求不会因到期或 Redis 数据丢失而再次执行。派发后即使上游报错或结算回滚,也须使用新消息 ID 发起另一次执行;派发前失败可使用原 ID 重试。 |
| X-Resume-Message-Id | header | string | 可选 | 使用原 API 密钥和相同请求体重放已生成的 SSE 流,不会再次调用上游或计费。缓存保留 10 分钟,输出总量上限为 4 MiB;中断后的续写须使用新的消息 ID。 |
| X-Resume-From-Offset | header | integer | 可选 | 已接收的完整 SSE 事件数,与最后一个 SSE id 一致,从 0 开始;单位不是 UTF-8 字节、令牌或字符。优先于 Last-Event-ID。 |
| Last-Event-ID | header | integer | 可选 | 未提供 X-Resume-From-Offset 时使用的完整 SSE 事件偏移量。 |
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
请求体
必填{
"contents": [
{
"parts": [
{
"text": "Explain edge computing briefly."
}
]
}
]
}响应
data: {"candidates":[{"content":{"role":"model","parts":[{"text":"Edge computing reduces latency."}]}}]}
Gemini Developer API 上的 Gemini 4 Argon 仅支持 Standard 推理。请省略 serviceTier/service_tier 或将其设为 standard;其他取值会在外发上游前返回 HTTP 400。 启用计费时,tools 或 Responses input.additional_tools 中声明的内置网络搜索要求已编译的价格规则覆盖 web_search_queries 及对应请求维度。命名空间工具声明会被检查,但不会将客户端函数视为内置搜索。在初始资金预留前,路由按顺序检查符合条件且已授权的候选者,并跳过未配置所需搜索计价的候选者。必要的渠道/提供商及连续性亲和性限制仍会强制执行。若没有允许的候选者具备计价覆盖,准入将在提供方派发或资金预留前返回 HTTP 503 search_tool_pricing_not_configured。每个实际的故障回退及供应层级候选者都会在派发前再次检查;缺失计价绝不消耗提供方尝试次数。对于企业后付费请求,结算前将根据剩余授权预算检查超出初始估算的实际提供方用量。预算拒绝会保留已记录的用量和价格以供核对。客户端函数工具不受影响。 原生请求保留提供方参数,但须符合所选模型的官方支持。跨协议请求通过请求中间表示(IR)映射受支持的内容和控制。未映射的扩展和近似控制记录在转换诊断中,而不会拒绝其他可用的请求。畸形的源内容仍返回 HTTP 400。无法表示的跨协议工具声明会在资金准入前返回 HTTP 400,而不会被静默丢弃;符合条件的原生路由可保留原生专属工具。Anthropic stop_sequences 映射到 Chat 的 stop;不会伪造上游未报告的匹配序列。使用 Responses previous_response_id/conversation、Anthropic thread 或 Gemini cachedContent 的请求需要其服务端状态。即使输入包含重复的历史记录,这些引用也绝不会被丢弃。路由会排除无法保留状态的转换,并优先选择符合条件的原生路由;状态归属仍取决于原始服务商/账户以及现有的连续性亲和性检查。如果所有候选均因此原因被排除,则在服务商派发前返回 HTTP 422 conversation_state_unavailable。网关当前不会物化引用的历史。仅原生协议可用性并不能证明所选账户中存在私有状态 ID。回退不会自动将 json_schema 降级为 json_object。 配置支持时,Chat Completions、Responses、Anthropic Messages 和 Gemini generateContent 可使用 model=auto 或 auto-cn。在特征打分之前,智能路由会过滤原生 json_schema/json_object 支持、显式关闭思考支持、完整输入长度加上请求的输出预留以及所需的输入模态。文本上下文长度包括完整的系统/历史/工具定义及结果和 JSON 结构,在分词器集成前按每个预估文本 token 对应一个 UTF-16 字符计算。在此预估中,显式媒体传输载荷会被替换为类型占位符;Base64 长度不是媒体 token 计数。实际媒体 token 用量和限制仍取决于特定服务商并在上游校验。JSON 和思考关闭支持来自已发布的 llm_capabilities(jsonSchema、jsonObject、reasoning、reasoningDisable);缺失的硬能力事实不视为支持。无推理能力的模型满足思考关闭。推理强度、摘要详细度、隐藏思考和可选输出元数据不作为候选者过滤条件。配置 Redis 时,Auto 首先检查租户、API 密钥、路由模式和协议范围内的显式客户端会话绑定,然后检查历史指纹。会话提取优先采用 X-Claude-Code-Session-Id、X-OpenCode-Session-Id、X-DeepSeek-Harness-Session-Id、X-QwenWork-Session-Id 和 thread-id,其次是 Responses client_metadata session_id/thread_id 以及 JSON x-codex-turn-metadata 中的相同字段。通用的 X-Session-Id、session_id、session-id、X-Cursor-Session 和 X-OpenClaw-Session-Id 紧随其后,接着是请求体中的 session_id、sessionId、metadata.session_id 和 metadata.sessionId。Anthropic 还接受 JSON metadata.user_id 内部的 session_id。X-Task-ID、X-OpenCode-Session 和 X-Session-Affinity 仅作为回退标识。KimiCLI/ User-Agent 还会额外启用已知的 Chat Completions prompt_cache_key 或 Anthropic 纯文本 metadata.user_id 会话惯例。缺失或畸形的标识符不会导致请求被拒绝。用户/账户、请求、提示词、轮次及父级标识符不会被全局视为会话 ID。会话查找失败仍会尝试历史匹配;两种绑定仅在成功完成时更新。History v2 排除非消息角色/控制项和不完整的工具调用标识符;没有 User 边界意味着包含所有可用历史。有效命中会在重新检查当前候选者资格后跳过 Jev 打分及其路由费用;若该绑定模型失败,Auto 将绕过绑定并评分一次以填充剩余的不同模型尝试。未命中和缓存失败使用正常评分。绑定在 24 小时后过期,且仅在成功的 JSON 或完整的 SSE 响应后写入;取消、未完成、模糊或过大的流不会创建绑定。智能路由对 API 密钥和协议允许的剩余当前网关目录模型进行评分,然后选定的具体模型遵循现有的权限、渠道路由和计费规则。对于 auto/auto-cn,来自 Chat Completions、Responses 和 Anthropic 的 Vertex Gemini 文本请求使用 Vertex 兼容 OpenAI 的 Chat 端点,采用相同的账户、模型和已发布的 Gemini 资费。Chat 消息/工具载荷予以保留;Responses 和 Anthropic 仅转换为 Chat。包含视频的 Auto 请求保留原生 Gemini generateContent/streamGenerateContent 转换,因为 Vertex Chat 拒绝 video_url;媒体字节、混合音频、账户和 Gemini 计价予以保留。显式模型请求和原生 Gemini/媒体路径保留其现有路由。价格和上下文限制来自当前已发布的目录;缺失的上下文限制可使用版本化能力快照并记录日志。可选能力覆盖不定义候选列表。任务特征失败记录为降级并使用中性需求值。配置或打分凭证缺失、目录无效或无符合条件的模型返回 HTTP 503(auto_routing_not_configured、auto_routing_configuration_invalid、auto_routing_scorer_unavailable、auto_routing_no_candidates)。选择失败返回 auto_routing_failed。对于 Responses 历史,仅消息项(包括省略 type)需要 role;非消息项保留在完整上游请求中,不参与评分。Jev 仅接收用户/助手文本及最多 500 个加权字符的系统前缀;工具定义、调用/结果和其他角色均排除。评分前检查完整请求中的图像、音频、视频及文件内容块。已发布模型的输入模态必须覆盖所有附件类型,选中及回退渠道也必须在 metadata.input_modalities(亦接受 inputModalities)中显式声明这些类型;不兼容渠道在派发前返回 capability_mismatch。未知 MIME 类型和不透明文件引用要求文件支持。媒体字节、URL 和文件 ID 从 Jev 材料中排除,替换为附件类型占位符;原始请求保持不变。不引入多模态需求特征或能力评分。非文本输出、生图工具和服务端存储的 Responses 连续会话仍需要显式模型,返回 HTTP 400 auto_routing_request_unsupported。在每次模型尝试不成功后,Auto 会尝试下一个排名的模型,包括任何非 2xx 响应、通用 HTTP 400 校验错误、服务商拒绝、5xx、超时、传输错误和未分类的本地执行失败。失败分类和不确定的服务商费用不会阻止回退。每次尝试都保留自己的结算凭据;重试不会将不确定的服务商结果转换为已确认的零费用。一次特征评估最多尝试三个不同的已排名模型。每次尝试在独立的执行 ID 下重复现有的授权、配额、速率限制、路由和资金检查。公开的 X-Request-Id 保持稳定;执行记录和计费元数据保留其关联。客户端取消或成功交付响应将停止跨模型回退。已交付给客户端的流不会重新启动。每个候选者仍必须通过授权和资金检查;未通过的检查绝不会授权上游外发。当所有候选者均失败时,将返回最终尝试的错误。显式模型请求不使用此回退。在需要 Jev 评分的最终模型执行成功后,Auto 会在公开父请求 ID 上追加一次平台路由费用:min(20 * L / 1000000 + 0.01505, 0.2) 积分,其中 L 是压缩后 Jev 状态的 UTF-16 字符串长度(对象的 JSON 序列化),在各次打分调用中统一计量一次。1 美元等于 100 积分;费用四舍五入到微美元(0.0001 积分)。失败或不完整的流以及失败的最终执行不产生此费用。计费模式为 auto,包括 auto-cn 请求。公开 Auto 请求 ID 的请求费用查询包含其路由费和所有已结算子执行费用。
POST /v1beta/models/{model}/generateContent请求示例
curl \
--request POST \
--url 'https://api.anyint.ai/v1beta/models/<model>/generateContent' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"contents": [
{
"parts": [
{
"text": "Explain edge computing briefly."
}
]
}
]
}'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| model | path | string | 必填 | — |
| X-Client-Message-Id | header | string | 可选 | 启用租户范围的持久执行去重。只能使用相同请求体和 API 密钥重用消息 ID。已完成或可能已经派发的请求不会因到期或 Redis 数据丢失而再次执行。派发后即使上游报错或结算回滚,也须使用新消息 ID 发起另一次执行;派发前失败可使用原 ID 重试。 |
| X-Resume-Message-Id | header | string | 可选 | 使用原 API 密钥和相同请求体重放已生成的 SSE 流,不会再次调用上游或计费。缓存保留 10 分钟,输出总量上限为 4 MiB;中断后的续写须使用新的消息 ID。 |
| X-Resume-From-Offset | header | integer | 可选 | 已接收的完整 SSE 事件数,与最后一个 SSE id 一致,从 0 开始;单位不是 UTF-8 字节、令牌或字符。优先于 Last-Event-ID。 |
| Last-Event-ID | header | integer | 可选 | 未提供 X-Resume-From-Offset 时使用的完整 SSE 事件偏移量。 |
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
请求体
必填{
"contents": [
{
"parts": [
{
"text": "Explain edge computing briefly."
}
]
}
]
}响应
{
"candidates": [
{
"content": {
"role": "model",
"parts": [
{
"text": "Edge computing reduces latency."
}
]
}
}
]
}Gemini Developer API 上的 Gemini 4 Argon 仅支持 Standard 推理。请省略 serviceTier/service_tier 或将其设为 standard;其他取值会在外发上游前返回 HTTP 400。 启用计费时,tools 或 Responses input.additional_tools 中声明的内置网络搜索要求已编译的价格规则覆盖 web_search_queries 及对应请求维度。命名空间工具声明会被检查,但不会将客户端函数视为内置搜索。在初始资金预留前,路由按顺序检查符合条件且已授权的候选者,并跳过未配置所需搜索计价的候选者。必要的渠道/提供商及连续性亲和性限制仍会强制执行。若没有允许的候选者具备计价覆盖,准入将在提供方派发或资金预留前返回 HTTP 503 search_tool_pricing_not_configured。每个实际的故障回退及供应层级候选者都会在派发前再次检查;缺失计价绝不消耗提供方尝试次数。对于企业后付费请求,结算前将根据剩余授权预算检查超出初始估算的实际提供方用量。预算拒绝会保留已记录的用量和价格以供核对。客户端函数工具不受影响。 原生请求保留提供方参数,但须符合所选模型的官方支持。跨协议请求通过请求中间表示(IR)映射受支持的内容和控制。未映射的扩展和近似控制记录在转换诊断中,而不会拒绝其他可用的请求。畸形的源内容仍返回 HTTP 400。无法表示的跨协议工具声明会在资金准入前返回 HTTP 400,而不会被静默丢弃;符合条件的原生路由可保留原生专属工具。Anthropic stop_sequences 映射到 Chat 的 stop;不会伪造上游未报告的匹配序列。使用 Responses previous_response_id/conversation、Anthropic thread 或 Gemini cachedContent 的请求需要其服务端状态。即使输入包含重复的历史记录,这些引用也绝不会被丢弃。路由会排除无法保留状态的转换,并优先选择符合条件的原生路由;状态归属仍取决于原始服务商/账户以及现有的连续性亲和性检查。如果所有候选均因此原因被排除,则在服务商派发前返回 HTTP 422 conversation_state_unavailable。网关当前不会物化引用的历史。仅原生协议可用性并不能证明所选账户中存在私有状态 ID。回退不会自动将 json_schema 降级为 json_object。 配置支持时,Chat Completions、Responses、Anthropic Messages 和 Gemini generateContent 可使用 model=auto 或 auto-cn。在特征打分之前,智能路由会过滤原生 json_schema/json_object 支持、显式关闭思考支持、完整输入长度加上请求的输出预留以及所需的输入模态。文本上下文长度包括完整的系统/历史/工具定义及结果和 JSON 结构,在分词器集成前按每个预估文本 token 对应一个 UTF-16 字符计算。在此预估中,显式媒体传输载荷会被替换为类型占位符;Base64 长度不是媒体 token 计数。实际媒体 token 用量和限制仍取决于特定服务商并在上游校验。JSON 和思考关闭支持来自已发布的 llm_capabilities(jsonSchema、jsonObject、reasoning、reasoningDisable);缺失的硬能力事实不视为支持。无推理能力的模型满足思考关闭。推理强度、摘要详细度、隐藏思考和可选输出元数据不作为候选者过滤条件。配置 Redis 时,Auto 首先检查租户、API 密钥、路由模式和协议范围内的显式客户端会话绑定,然后检查历史指纹。会话提取优先采用 X-Claude-Code-Session-Id、X-OpenCode-Session-Id、X-DeepSeek-Harness-Session-Id、X-QwenWork-Session-Id 和 thread-id,其次是 Responses client_metadata session_id/thread_id 以及 JSON x-codex-turn-metadata 中的相同字段。通用的 X-Session-Id、session_id、session-id、X-Cursor-Session 和 X-OpenClaw-Session-Id 紧随其后,接着是请求体中的 session_id、sessionId、metadata.session_id 和 metadata.sessionId。Anthropic 还接受 JSON metadata.user_id 内部的 session_id。X-Task-ID、X-OpenCode-Session 和 X-Session-Affinity 仅作为回退标识。KimiCLI/ User-Agent 还会额外启用已知的 Chat Completions prompt_cache_key 或 Anthropic 纯文本 metadata.user_id 会话惯例。缺失或畸形的标识符不会导致请求被拒绝。用户/账户、请求、提示词、轮次及父级标识符不会被全局视为会话 ID。会话查找失败仍会尝试历史匹配;两种绑定仅在成功完成时更新。History v2 排除非消息角色/控制项和不完整的工具调用标识符;没有 User 边界意味着包含所有可用历史。有效命中会在重新检查当前候选者资格后跳过 Jev 打分及其路由费用;若该绑定模型失败,Auto 将绕过绑定并评分一次以填充剩余的不同模型尝试。未命中和缓存失败使用正常评分。绑定在 24 小时后过期,且仅在成功的 JSON 或完整的 SSE 响应后写入;取消、未完成、模糊或过大的流不会创建绑定。智能路由对 API 密钥和协议允许的剩余当前网关目录模型进行评分,然后选定的具体模型遵循现有的权限、渠道路由和计费规则。对于 auto/auto-cn,来自 Chat Completions、Responses 和 Anthropic 的 Vertex Gemini 文本请求使用 Vertex 兼容 OpenAI 的 Chat 端点,采用相同的账户、模型和已发布的 Gemini 资费。Chat 消息/工具载荷予以保留;Responses 和 Anthropic 仅转换为 Chat。包含视频的 Auto 请求保留原生 Gemini generateContent/streamGenerateContent 转换,因为 Vertex Chat 拒绝 video_url;媒体字节、混合音频、账户和 Gemini 计价予以保留。显式模型请求和原生 Gemini/媒体路径保留其现有路由。价格和上下文限制来自当前已发布的目录;缺失的上下文限制可使用版本化能力快照并记录日志。可选能力覆盖不定义候选列表。任务特征失败记录为降级并使用中性需求值。配置或打分凭证缺失、目录无效或无符合条件的模型返回 HTTP 503(auto_routing_not_configured、auto_routing_configuration_invalid、auto_routing_scorer_unavailable、auto_routing_no_candidates)。选择失败返回 auto_routing_failed。对于 Responses 历史,仅消息项(包括省略 type)需要 role;非消息项保留在完整上游请求中,不参与评分。Jev 仅接收用户/助手文本及最多 500 个加权字符的系统前缀;工具定义、调用/结果和其他角色均排除。评分前检查完整请求中的图像、音频、视频及文件内容块。已发布模型的输入模态必须覆盖所有附件类型,选中及回退渠道也必须在 metadata.input_modalities(亦接受 inputModalities)中显式声明这些类型;不兼容渠道在派发前返回 capability_mismatch。未知 MIME 类型和不透明文件引用要求文件支持。媒体字节、URL 和文件 ID 从 Jev 材料中排除,替换为附件类型占位符;原始请求保持不变。不引入多模态需求特征或能力评分。非文本输出、生图工具和服务端存储的 Responses 连续会话仍需要显式模型,返回 HTTP 400 auto_routing_request_unsupported。在每次模型尝试不成功后,Auto 会尝试下一个排名的模型,包括任何非 2xx 响应、通用 HTTP 400 校验错误、服务商拒绝、5xx、超时、传输错误和未分类的本地执行失败。失败分类和不确定的服务商费用不会阻止回退。每次尝试都保留自己的结算凭据;重试不会将不确定的服务商结果转换为已确认的零费用。一次特征评估最多尝试三个不同的已排名模型。每次尝试在独立的执行 ID 下重复现有的授权、配额、速率限制、路由和资金检查。公开的 X-Request-Id 保持稳定;执行记录和计费元数据保留其关联。客户端取消或成功交付响应将停止跨模型回退。已交付给客户端的流不会重新启动。每个候选者仍必须通过授权和资金检查;未通过的检查绝不会授权上游外发。当所有候选者均失败时,将返回最终尝试的错误。显式模型请求不使用此回退。在需要 Jev 评分的最终模型执行成功后,Auto 会在公开父请求 ID 上追加一次平台路由费用:min(20 * L / 1000000 + 0.01505, 0.2) 积分,其中 L 是压缩后 Jev 状态的 UTF-16 字符串长度(对象的 JSON 序列化),在各次打分调用中统一计量一次。1 美元等于 100 积分;费用四舍五入到微美元(0.0001 积分)。失败或不完整的流以及失败的最终执行不产生此费用。计费模式为 auto,包括 auto-cn 请求。公开 Auto 请求 ID 的请求费用查询包含其路由费和所有已结算子执行费用。
POST /v1beta/models/{model}/streamGenerateContent请求示例
curl \
--request POST \
--url 'https://api.anyint.ai/v1beta/models/<model>/streamGenerateContent' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: text/event-stream' \
--header 'Content-Type: application/json' \
--data '{
"contents": [
{
"parts": [
{
"text": "Explain edge computing briefly."
}
]
}
]
}'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| model | path | string | 必填 | — |
| alt | query | string | 可选 | — |
| X-Client-Message-Id | header | string | 可选 | 启用租户范围的持久执行去重。只能使用相同请求体和 API 密钥重用消息 ID。已完成或可能已经派发的请求不会因到期或 Redis 数据丢失而再次执行。派发后即使上游报错或结算回滚,也须使用新消息 ID 发起另一次执行;派发前失败可使用原 ID 重试。 |
| X-Resume-Message-Id | header | string | 可选 | 使用原 API 密钥和相同请求体重放已生成的 SSE 流,不会再次调用上游或计费。缓存保留 10 分钟,输出总量上限为 4 MiB;中断后的续写须使用新的消息 ID。 |
| X-Resume-From-Offset | header | integer | 可选 | 已接收的完整 SSE 事件数,与最后一个 SSE id 一致,从 0 开始;单位不是 UTF-8 字节、令牌或字符。优先于 Last-Event-ID。 |
| Last-Event-ID | header | integer | 可选 | 未提供 X-Resume-From-Offset 时使用的完整 SSE 事件偏移量。 |
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
请求体
必填{
"contents": [
{
"parts": [
{
"text": "Explain edge computing briefly."
}
]
}
]
}响应
data: {"candidates":[{"content":{"role":"model","parts":[{"text":"Edge computing reduces latency."}]}}]}
其他接口(Knowledge Crystallization)
1 个端点导出已发布的 AI 对话事件,用于同步本地 Markdown 笔记。
请求示例
curl \
--request GET \
--url 'https://api.anyint.ai/v1/knowledge/export' \
--header 'Authorization: Bearer <ANYINT_API_KEY>' \
--header 'Accept: application/json'身份验证
http · bearer在 Authorization 请求头中以 Bearer 形式传递 AnyInt 开发者 API 密钥。参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| cursor | query | string | 可选 | — |
| limit | query | integer | 可选 | — |
| collection_id | query | string | 可选 | — |
| X-Request-Id | header | string | 可选 | 可选的客户端关联 ID。有效值(8–128 个字母、数字、点、下划线、冒号或连字符)仅作为诊断哈希保留。此请求头不会对请求进行去重。每个 HTTP 请求都会在 X-Request-Id 响应头中获得一个新的网关执行 ID;请使用该返回的 ID 进行支持与请求链路追踪。如需执行去重,请使用文档中说明的消息恢复协议。 |
响应
{
"schema_version": "1.0.0",
"collection_id": "default",
"collection_generation": 1,
"events": [],
"next_cursor": null,
"has_more": false,
"snapshot_upper_bound": "2026-09-30T10:00:00.000Z",
"pending_summary": {
"pending_event_count": 0
},
"status": "OK"
}