快速开始
5 分钟内完成第一次 API 调用，了解 V1 API、Skills 与 MCP 三种接入方式
云擎数智 网关对外提供三种主要接入方式：
| 接入方式 | 适合谁 | 文档入口 |
|---|---|---|
| V1 开放 API | 后端、移动端、第三方 SDK 集成 | 通用约定 |
| Skills | Claude、Cursor、Codex、OpenClaw、Hermes、NemoClaw 等 Agent | Skills |
| MCP 服务 | 通过 MCP 协议接入的客户端 | 连接与配置 |
本指南帮助你在 5 分钟内完成第一次 API 调用。示例中的 sk-xxx 请替换为你的 API Key。
1. 获取 API Key
在 云擎数智 管理台创建 API Key（令牌），格式通常为 sk-xxxxxxxx。
如需限制模型或配置 IP 白名单，在令牌设置中完成后再用于集成。
2. 查看可用模型
curl https://www.yunsell.com/v1/models \
-H "Authorization: Bearer sk-xxx"
成功时返回 success: true 及 data[] 模型列表。记下你要使用的 data[].id，并查看 supported_endpoint_types 确认该模型支持的能力。
详见 模型 API。
3. 按场景选择第一个接口
文本对话（最常用）
curl https://www.yunsell.com/v1/chat/completions \
-H "Authorization: Bearer sk-xxx" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-4o",
"messages": [{"role": "user", "content": "Hello"}]
}'
详见 文本 API。
文生图
curl https://www.yunsell.com/v1/images/generations \
-H "Authorization: Bearer sk-xxx" \
-H "Content-Type: application/json" \
-d '{
"model": "dall-e-3",
"prompt": "A cat on a windowsill",
"size": "1024x1024",
"response_format": "url"
}'
详见 图像 API。
视频生成（异步）
# 1. 创建任务
curl https://www.yunsell.com/v1/videos \
-H "Authorization: Bearer sk-xxx" \
-H "Content-Type: application/json" \
-d '{
"model": "sora-2",
"prompt": "A cat walking on the beach at sunset",
"size": "1280x720",
"seconds": 8
}'
# 2. 轮询状态（将 task_xxx 替换为上一步返回的 id）
curl https://www.yunsell.com/v1/videos/task_xxx \
-H "Authorization: Bearer sk-xxx"
# 3. 完成后下载
curl -L https://www.yunsell.com/v1/videos/task_xxx/content \
-H "Authorization: Bearer sk-xxx" \
-o output.mp4
详见 视频 API。
文本转语音
# 1. 查询音色
curl https://www.yunsell.com/v1/audio/voice/tts-1 \
-H "Authorization: Bearer sk-xxx"
# 2. 合成语音
curl https://www.yunsell.com/v1/audio/speech \
-H "Authorization: Bearer sk-xxx" \
-H "Content-Type: application/json" \
-d '{
"model": "tts-1",
"input": "Hello world",
"voice": "alloy",
"response_format": "mp3"
}' \
-o speech.mp3
详见 音频 API。
4. 在 Agent 中使用 Skills（可选）
若你使用 Claude、Cursor、Codex、OpenClaw、Hermes、NemoClaw 等 Agent 平台：
- 下载并解压
yunsell-ai-skills.zip到 Agent 的 Skills 目录 - 在
yunsell-ai-skills/.env中配置：
YUNSELL_BASE_URL=https://www.yunsell.com
YUNSELL_API_KEY=sk-xxx
- 在对话中直接描述生成需求
详见 Skills。
5. 文档导航
入门
V1 开放 API（12 条）
MCP 服务
Skills
6. 下一步
| 目标 | 阅读 |
|---|---|
| 了解 REST / Skills 如何选型 | 选型指南 |
| 查阅完整接口参数 | API 能力文档 |
| 在 Agent 中调用多模态 | Skills |
| 理解错误与计费 | 通用约定 · 错误响应 |
通用约定速查：Base URL https://www.yunsell.com · 鉴权 Authorization: Bearer sk-xxx · 公开 API /v1/* · MCP /mcp