快速开始
获取 API Key，并通过最小示例调用文本、图像和视频模型。
获取 API Key，并通过最小示例完成文本对话、图像生成和视频生成调用。
第 2 步：获取 API Key
- 前往 API Keys。
- 点击创建 API 密钥。
- 复制并安全保存你的 API Key。
安全保存 API Key
不要在浏览器前端、公开仓库、截图或日志中保存完整 API Key。疑似泄露时应立即撤销。
第 3 步：确认可用额度
API 调用会消耗账户额度。发起请求前，请在余额与充值页面确认账户具有可用额度；充值方式和到账结果以控制台显示为准。
第 4 步：完成首次 API 调用
以下示例使用当前站点的 API 地址和示例模型。实际调用前，请从模型广场确认当前 API Key 可以使用对应模型。
与 LLM 对话
Chat Completions 兼容接口可以通过 OpenAI SDK 或 HTTP 请求调用。
from openai import OpenAI
client = OpenAI(
api_key="your-api-key",
base_url="https://api.agtcloud.cn/v1",
)
response = client.chat.completions.create(
model="deepseek-v4-flash",
messages=[
{"role": "user", "content": "你好！你能做什么？"}
],
)
print(response.choices[0].message.content)响应文本位于 choices[0].message.content。更多参数请查看 Chat Completions。
生成图像
curl 'https://api.agtcloud.cn/v1/images/generations' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer your-api-key' \
--data '{
"model": "qwen-image",
"prompt": "一座漂浮在云海之上的未来城市"
}'生成视频
curl 'https://api.agtcloud.cn/v1/video/generations' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer your-api-key' \
--data '{
"model": "doubao-seedance-2-5-260628",
"prompt": "一艘宇宙飞船穿过蓝色星云"
}'创建成功后，保存响应中的 task_id，再查询任务状态和结果：
curl 'https://api.agtcloud.cn/v1/video/generations/your-task-id' \
-H 'Authorization: Bearer your-api-key'保护生产环境中的 API Key
your-api-key 仅用于标记替换位置。生产项目应通过服务端环境变量或密钥管理服务读取 API Key，不要把真实密钥提交到代码仓库或发送到浏览器前端。
如需在浏览器中验证请求，可以打开在线调试。
第 5 步：探索模型
前往模型广场查找适合任务的模型。调用前，请确认模型支持的协议、参数和当前账户权限。