OpenAI 兼容 API 手册

图片生成任务

通过 OpenAI 兼容图片端点创建任务，并用 /v1/images/tasks/:id 查询 TaskLog 状态、扣费、上游任务 ID 和输出 URL。在线体验创建的图片任务也可用同一查询端点读取；后台全局任务列表默认脱敏 prompt、payload、上游 ID 和 URL。

创建 API Key 返回中文文档

POST /v1/images/generations

Images

curl https://api09.com/v1/images/generations \
  -H "Authorization: Bearer sk-api09_xxx" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-image-2","prompt":"一张 api09 控制台产品海报","resolution":"1K","size":"1:1","response_format":"url"}'

curl https://api09.com/v1/images/tasks/task_id \
  -H "Authorization: Bearer sk-api09_xxx"

请求字段

字段	类型	说明
Authorization	header	Bearer sk-api09_xxx。
model	string	图片模型 ID，例如 gpt-image-2。
prompt	string	图片生成描述。
resolution / size	string	可选，控制分辨率、比例和预估积分。
GET /v1/images/tasks/:id	path	查询图片任务状态，任务必须属于当前 API Key 所属用户。

响应与计费

字段	类型	说明
data.id	string	api09 TaskLog ID，可用于状态查询和审计追踪。
data.status	string	RUNNING / SUCCEEDED / FAILED / CANCELED。
data.creditsEstimate / creditsCharged	number	预估积分与实际扣费积分。
data.upstreamTaskId	string	上游任务 ID；用户自己的任务查询可见，后台全局列表默认脱敏。
data.outputUrl	string	上游返回并持久化的图片结果 URL；后台全局列表默认脱敏。
data.requestPayload	object	原始 payload 内的 URL、base64、token、authorization 等字段会被遮罩。

积分统一换算：1 USD = 200 积分。

生产检查

创建任务写 TASK_CREATE 审计

失败任务保留 errorMessage

查询端点必须按 user_id 隔离

在线体验任务日志