快速开始

开始前，请先获取 Yir API Key，并设置 YIR_API_KEY。

一个幂等键只代表一个逻辑请求。相同请求重试时复用它，新任务则生成新值。

KIE 兼容
APIMart 兼容

提交后从 data.taskId 读取任务 ID，再通过 recordInfo 查询。

curl --request POST \
  --url "https://gateway.yir.ai/kie/api/v1/jobs/createTask" \
  --header "Authorization: Bearer $YIR_API_KEY" \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: $YIR_IDEMPOTENCY_KEY" \
  --data '{"model":"gpt-image-2-text-to-image","input":{"prompt":"A quiet observatory above a sea of clouds","resolution":"1K","aspect_ratio":"1:1"}}'

提交后从 data[0].task_id 读取任务 ID，再通过任务路径查询。

curl --request POST \
  --url "https://gateway.yir.ai/apimart/v1/images/generations" \
  --header "Authorization: Bearer $YIR_API_KEY" \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: $YIR_IDEMPOTENCY_KEY" \
  --data '{"model":"gpt-image-2","prompt":"A quiet observatory above a sea of clouds","size":"1:1","resolution":"1k","n":1}'

轮询必须设置合理间隔和总期限。网络超时或活动状态只表示结果未知或任务仍在运行，不代表生成已经失败。

指南

核心概念

API 参考

帮助

快速开始