# Yet API：从注册到第一条 API 请求

更新日期：2026-09-08。适用对象：使用支持自定义 Base URL 的应用、SDK 或创作工作流的开发者。

接入咨询：微信 `49006858`。咨询时说明模型、工具与调用需求，不提供 API 密钥。

## 1. 确认模型与价格

打开 [模型广场](https://api.yetagi.com/model-plaza)，确认需要的模型标识、接口能力、规格与计费单位。
模型名称必须使用站内完整标识，不能只填写展示名称或省略后缀。
对话、图像和视频接口分别接入，不能因为一个接口兼容就推断所有接口兼容。

## 2. 注册、验证邮箱并确认额度

进入 [注册页面](https://api.yetagi.com/register)，按页面完成邮箱验证；已有账号可直接 [登录](https://api.yetagi.com/login)。
登录后在“充值/订阅”页面查看支付方式、起充金额与到账说明。在确认价格与使用需求后再充值。

## 3. 创建独立密钥

进入控制台“API 密钥”，为自己的项目创建密钥，确认模型权限，按需要设置额度和有效期。
密钥只保存在自己的应用或服务端环境中，不要放进公开仓库、前端网页、截图或评论区。

## 4. 配置地址和模型

| 配置 | 值 |
| --- | --- |
| 站点地址 | `https://api.yetagi.com` |
| SDK Base URL | `https://api.yetagi.com/v1` |
| API Key | 在本站控制台创建的项目密钥 |
| Model | 从模型广场复制的完整模型标识 |

若工具自动拼接 `/v1`，请按工具说明使用站点地址，避免重复成为 `/v1/v1`。

以下仅演示本站首页已公开的对话请求格式，不会自动调用。运行时会按实际请求计费。
先在自己的环境中设置 `YET_API_KEY` 和 `YET_MODEL`；示例不要直接填入未经核对的模型名。

```bash
curl https://api.yetagi.com/v1/chat/completions \
  -H "Authorization: Bearer ${YET_API_KEY}" \
  -H 'Content-Type: application/json' \
  --data "{\"model\":\"${YET_MODEL}\",\"messages\":[{\"role\":\"user\",\"content\":\"请回复：连接成功\"}]}"
```

模型标识使用目录内的固定值；不要把用户输入直接拼入 shell 或 JSON。应用开发中应使用正常的 JSON 序列化。

## 5. 核对结果与账单

用一条小规模、非敏感任务核对返回内容、耗时与控制台用量；图像或视频任务还要核对生成记录、结果文件与最终扣费。
不要用 `/health` 成功代替模型请求成功；`/health` 只表示站点服务健康检查。

## 常见排查顺序

| 现象 | 优先检查 |
| --- | --- |
| 401 / 鉴权失败 | 是否使用本站密钥，密钥是否有效，Authorization 格式是否正确 |
| 模型不可用或权限不足 | 完整模型标识、密钥权限、规格、额度 |
| 404 | Base URL 是否重复带 `/v1`，请求是否发到对应接口 |
| 429 / 限流 | 并发和频率，按返回信息降低请求速率 |
| 视频仍在处理中 | 查询任务状态，避免重复提交造成额外费用 |

具体原因以接口返回为准。报错交流只提供已脱敏的状态码和请求格式，不提供密钥。

## 图片、视频接入前需要确认

图片：模型标识、生成或编辑能力、尺寸、图片数量、返回格式。
视频：模型标识、输入素材要求、时长、分辨率、任务查询方式与文件保留时间。
当前完整接口差异请在实际使用页面核实。本指南不代表所有图片高级参数、所有视频规格或所有第三方客户端已验证。

[返回产品说明](https://api.yetagi.com/yet-home/index.md) · [计费说明](https://api.yetagi.com/yet-home/pricing.md)