> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yir.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Yir 异步 AI Gateway

> 使用 Yir 构建来源兼容、可追踪的异步图片生成工作流。

Yir 面向图片和视频等长耗时生成任务，提供稳定任务 ID、明确的轮询状态和一致的费用事实，同时在服务端管理经过认证的算力渠道。

<Info>
  当前开发者预览仅覆盖 GPT Image 2 文生图的 KIE 兼容和 APIMart 兼容入口，不代表 Yir v1 的全部公开能力。
</Info>

<CardGroup cols={2}>
  <Card title="快速开始" icon="rocket" href="/zh/getting-started/quickstart">
    完成一次提交、查询和结果读取闭环。
  </Card>

  <Card title="生产集成" icon="shield-check" href="/zh/guides/production-integration">
    正确处理幂等、轮询、超时和安全边界。
  </Card>

  <Card title="任务生命周期" icon="workflow" href="/zh/concepts/task-lifecycle">
    理解活动状态、终态和未知结果。
  </Card>

  <Card title="费用与结算" icon="wallet-cards" href="/zh/concepts/billing">
    了解预授权、结算和释放。
  </Card>
</CardGroup>

所有 Gateway 请求都使用同一个主机和 Yir API Key：

```text theme={null}
https://gateway.yir.ai
```

请求中不要携带 KIE、APIMart 或其他上游密钥。上游 Credential 由 Yir 管理，不属于客户端合同。