API 快速开始

API 快速开始：阅读要点

从账户模型发现到第一次请求，理解OmniAI Lab VIP API 的鉴权、参数核对与异步任务处理。

先发现，再提交

在开放平台控制台创建自己的 API Key。把完整凭证保存在服务端环境变量或安全的密钥存储中，不放进网页源码、公开仓库或截图。

调用 GET /v1/models 查询账户可用模型，再选择相应的生成接口。文档中的模型 ID 占位符需要替换成实际可用 ID；公开目录不等于某个账户已获得全部权限。

区分任务创建和任务完成

同步接口按其协议处理返回内容；异步生成返回任务标识后，继续查询 GET /v1/tasks/{task_id}。只在 succeeded 状态读取结果；queued、processing 表示仍未完成，failed、cancelled 应检查错误信息与任务记录。

创建类请求需要按接口说明使用 Idempotency-Key。同一个逻辑请求重试时保持该键与请求内容一致；不同业务请求不要复用同一键。

curl "$API_BASE_URL/v1/models" \
  -H "Authorization: Bearer $YOUR_API_KEY"

内容核对： · OmniAI Lab VIP产品文档