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

# SDK 与协议兼容性

> 确认当前正式支持的 REST 地址与鉴权方式，并了解 Google Gen AI SDK、自定义 Base URL 和 OpenAI SDK 的兼容边界。

当前正式支持的是本站 [OpenAPI](/openapi.json)描述的 Gemini 风格 REST 子集。使用普通 HTTP 客户端，并配置统一的 API 地址和 Bearer 鉴权：

```text theme={"system"}
API 地址：https://api.yingtu.ai
Authorization: Bearer YOUR_YINGTU_API_KEY
```

## 目前应该使用哪种客户端

| 调用方式                           | 支持状态                |
| ------------------------------ | ------------------- |
| cURL 或其他 HTTP 客户端              | 正式支持                |
| Python `requests` 或同类库         | 正式支持                |
| JavaScript `fetch` 或同类接口       | 正式支持                |
| Google Gen AI SDK 自定义 Base URL | 暂未进入正式支持范围          |
| OpenAI SDK                     | 不支持调用这些 Gemini 原生路由 |

[快速开始](/cn/getting-started/quickstart)已经提供完整的 cURL、Python 和 Node.js 代码。某个库能够自行发送 HTTP 请求，并不代表它的鉴权、路径拼接、重试、响应类型和后续版本都获得正式兼容支持。

## 三个受支持的 REST 接口

| 任务        | 接口                                                 |
| --------- | -------------------------------------------------- |
| 同步生成或图片编辑 | `POST /v1beta/models/{model}:generateContent`      |
| 提交异步任务    | `POST /v1beta/models/{model}:asyncGenerateContent` |
| 查询任务      | `GET /v1/tasks/{task_id}`                          |

三个接口都使用同一个 Bearer 请求头。准确模型 ID 可以从[模型广场](https://api.yingtu.ai/pricing)或[模型 ID 页面](/cn/resources/model-ids)复制。

## Gemini 风格请求不等于完整兼容

请求结构采用 Google GenerateContent 的主要形式，但当前公开接口不是对所有 Gemini 字段、工具、文件流程、鉴权方式、流式方法或 SDK 功能的完整兼容承诺。

只有同时出现在当前 OpenAPI 和对应模型参数页中的能力，才属于正式支持范围。模型专属在线测试也比通用协议更窄；在线请求成功不能证明某个 SDK 已经通过兼容验收。

如果生产系统必须使用指定 SDK，请将 SDK 名称、版本、语言、鉴权要求和必需接口发送给 [API 技术支持](/cn/resources/technical-support)。在版本化兼容矩阵发布前，以 REST 示例为维护入口。

<CardGroup cols={2}>
  <Card title="运行 REST 快速开始" icon="rocket" href="/cn/getting-started/quickstart">
    使用 cURL、Python 或 Node.js 生成并解析图片。
  </Card>

  <Card title="检查 OpenAPI" icon="braces" href="/cn/api-reference/generate-content">
    查看准确请求、响应和错误合同。
  </Card>
</CardGroup>