第一次调用只需要三步
图片接口使用 OGA 原生 API；文本 Claude Opus 5.5 另提供 OpenAI-compatible /v1/chat/completions，方便接入常见开源框架。请按模态选择对应接口。
认证与 Key 安全
需要鉴权的接口使用 Authorization: Bearer <YOUR_OGA_API_KEY>。这是 OGA 平台 Key，不是任何上游供应商凭据。请只在受控后端或本页同源调试器中使用。
API Key 不属于查询参数，也不应进入浏览器历史、分析系统或访问日志。
密码框只在当前页面内存中保留 Key；示例复制始终使用占位符。
在 OpenAI-compatible 应用中使用文本模型
在支持自定义 OpenAI 服务的框架中，选择 OpenAI-compatible，然后填写下面三项。不需要填写供应商地址或供应商 Key。
- Base URL
https://opengptapi.com/v1- API Key
- 你创建的 OGA 用户 full Key
- Model
claude-opus-5-5不填写分组时按 API Key 的允许分组和路由策略选择。
如何选择不同价格分组？
同一 Claude 模型支持两种分组写法：不填写分组时按 API Key 的允许/排除规则和策略自动选择；明确填写分组时使用“分组/模型”，例如 002/claude-opus-5-5。指定的分组没有 Key 权限会在扣费前返回 403。
001/claude-opus-5-5·claude-opus-5-5-group-001— 分组 001002/claude-opus-5-5·claude-opus-5-5-group-002— 分组 002003/claude-opus-5-5·claude-opus-5-5-group-003— 分组 003004/claude-opus-5-5·claude-opus-5-5-group-004— 分组 004
查看 Python OpenAI SDK 示例
这是按 Token 计费的调用示例，阅读和复制不会发请求。运行前确认当前分组价格和 Key 额度。
from openai import OpenAI
client = OpenAI(
base_url="https://opengptapi.com/v1",
api_key="YOUR_OGA_API_KEY",
)
result = client.chat.completions.create(
model="002/claude-opus-5-5",
messages=[{"role": "user", "content": "你好"}],
max_completion_tokens=512,
)
print(result.choices[0].message.content)流式、工具调用和重试规则
支持 stream=true、stream_options.include_usage、system/developer、多轮文本消息和 function tools/tool_calls。工具由你的应用执行，再以 tool 消息回传；OGA 不替你执行函数。
输出上限可以使用 max_tokens 或 max_completion_tokens，默认4096。temperature 和 top_p 范围为0–1，n只能为1。图像/音频输入、strict=true工具、JSON Schema强约束和 Responses API 不在本次兼容范围。
建议为每次业务调用指定 Idempotency-Key，并在重试时保持同一个键与完整请求。无显式键的首次请求会生成独立标识；它不是按提示词去重。Stainless SDK 标记的无键自动重试会被拒绝，其他客户端也应禁用自动重试或提供稳定键。已提交任务重放会保留原分组，不会因为 API Key 策略或价格后来变化而重新选组。
超时、断流或 usage 未知时，先通过 X-OGA-Task-Id / Location 查询原任务；不要换键、换组盲重提。断开客户端不会取消已受理请求，也不表示免费。
文本模型与 Token 计价
文本模型同时提供 OGA 原生文本任务接口和 OpenAI-compatible Chat Completions。输入、输出和缓存 Token 按每百万 Token 分别计价；分组在任务创建时锁价。
文本模型 · Token 计价
文本模型，按百万 Token 计费
选择模型和适合你的价格分组。输入、输出和缓存分别计费，任务创建时锁价。
分组 001
claude-opus-5-5
- 输入 / 1M
- $0.661827
- 输出 / 1M
- $3.309132
- 缓存读取 / 1M
- $0.066183
- 缓存写入 / 1M
- $0.827283
分组 002
claude-opus-5-5
- 输入 / 1M
- $5.000000
- 输出 / 1M
- $25.000000
- 缓存读取 / 1M
- $5.000000
- 缓存写入 / 1M
- $5.000000
分组 003
claude-opus-5-5
- 输入 / 1M
- $8.500000
- 输出 / 1M
- $42.500000
- 缓存读取 / 1M
- $8.500000
- 缓存写入 / 1M
- $8.500000
分组 004
claude-opus-5-5
- 输入 / 1M
- $36.500000
- 输出 / 1M
- $182.500000
- 缓存读取 / 1M
- $36.500000
- 缓存写入 / 1M
- $36.500000
用图表比较输入与输出价格
分组价格对比
同一单位比较输入与输出，缓存单价见上方。具体任务按锁定费率与实际用量结算。
| 分组 | 输入 | 输出 |
|---|---|---|
| claude-opus-5-5 · 分组 001 | 0.661827 | 3.309132 |
| claude-opus-5-5 · 分组 002 | 5.000000 | 25.000000 |
| claude-opus-5-5 · 分组 003 | 8.500000 | 42.500000 |
| claude-opus-5-5 · 分组 004 | 36.500000 | 182.500000 |
价格快照时间：2026-11-11T18:06:23.801292Z
先读模型，再决定参数
1K、2K、4K、比例、实际像素、参考图数量、输出格式、质量档位和价格都必须来自当前模型详情。多条渠道行的能力可能不同，未公布的组合不能自行推测。
幂等与未知受理
OGA 原生写请求必须提供业务唯一的 Idempotency-Key。OpenAI-compatible 首次请求可省略，由入口生成独立标识；建议主动指定稳定键并在重试时复用。相同键与完整请求只关联原任务，同键不同语义返回409。未知结果先查原任务，不能换键盲重提。
价格、计费与退款
只以模型详情中的当前公开 price_matrix 为准。任务创建时锁定最终渠道与价格快照，完成后按同一账务合同结算；退款遵循渠道行公开的结构化规则。
错误与结果有效期
HTTP 状态表达请求结果，错误信封包含稳定业务码、request_id、retryable 与字段级原因。普通业务拒绝不会伪装成 200 或 503。成功图片当前在服务端保留 3 小时，签名 URL 的到期时间等于自动删除边界。
本页是常用接口导览，不是第二份完整接口目录。/openapi.json 是全部 REST 业务能力的机器真值；相同 operation_id 同时作为 MCP tool name，Swagger 与 ReDoc 直接读取同一份定义。