快速开始
从注册账户到完成首次 API 调用的完整接入指南
快速开始
本指南将引导你完成 iCreat 平台接入的前置流程：注册账户、充值额度、创建 API Key，并通过 cURL 发起首次 API 请求。按步骤操作，通常可在 5 分钟内 完成首次调用。
前置条件
- 可正常访问
https://api.icreat.ai的网络环境 - 终端环境（macOS / Linux / Windows PowerShell 均可）
- 可选：安装 cURL 与 jq，便于发送请求与解析 JSON 响应
第一步：注册账户
访问 iCreat AI 使用以下两种方式之一注册：
方式一：Google 快捷登录
- 点击「Google 登录」按钮
- 使用 Google 账户授权
- 自动创建账户，立即可用
方式二：邮箱注册
前往 注册页面 创建 iCreat 账户：
- 填写用户名与邮箱地址
- 设置登录密码（8–20 位字符）
- 点击「获取验证码」，输入邮箱收到的验证码（若未收到，请检查垃圾邮件文件夹）
- 提交并完成注册 已有账户？直接 登录 进入控制台。
安全建议
请使用强密码并妥善保管登录凭证，切勿与他人共享账户信息。
第二步：充值额度
iCreat 采用 预付费额度 计费模式，API 调用将从账户余额中扣除相应费用。 登录控制台后，进入 钱包 页面完成充值：
- 不同模型的单次调用费用不同，详见 模型广场
- 余额不足时，API 将返回错误并拒绝请求，请及时充值
- 可在控制台查看实时余额与历史消费记录
计费说明
每次 API 调用的费用会实时写入使用日志，支持按 Key、按模型维度查询明细。
第三步：创建 API Key
API Key 是调用 iCreat API 的身份凭证，通过 HTTP Header 中的 Authorization: Bearer <API_KEY> 传递。
在 API Keys 页面创建密钥：
- 点击「添加」
- 填写密钥名称（建议按用途命名，如
production-backend、local-dev） - 可选：设置额度上限与过期时间，便于权限隔离与成本控制
- 提交创建
安全须知
- 密钥 仅在创建时完整显示一次，请立即复制并存储至安全位置（如密钥管理服务或环境变量）
- 禁止将 API Key 写入前端代码或提交至公开代码仓库
- 若密钥泄露，请立即在控制台吊销并重新创建
- 建议为不同环境、不同应用分别创建独立 Key，便于审计与轮换 更多细节请参阅 API Key 管理。
第四步：发起首次 API 调用
图像、视频等生成类接口采用 异步任务 模式，标准流程为 二段式：
提交任务 → 查询任务结果（可轮询直至终态）以下以 GPT-Image-2 文生图为例。请将 <your-api-key> 替换为上一步创建的密钥，全程使用同一 task_id。
4.1 提交任务
POST https://api.icreat.ai/v1/task/submit/openai/gpt-image-2
curl -X POST 'https://api.icreat.ai/v1/task/submit/openai/gpt-image-2' \
-H 'Authorization: Bearer <your-api-key>' \
-H 'Content-Type: application/json' \
-d '{
"prompt": "一只戴着墨镜的柴犬，赛博朋克风格",
"size": "1024x1024",
"quality": "high"
}'响应示例：
{
"task_id": "task-0192xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}请保存返回的 task_id，用于下一步查询。
4.2 查询任务结果（轮询）
POST https://api.icreat.ai/v1/task/result
使用同一 task_id 重复调用，直至 status 为 SUCCEEDED 或 FAILED。响应同时包含 status 与 result：处理中时 result 为 []；成功时 result 为资源数组，且响应含 costUSD。
curl -X POST 'https://api.icreat.ai/v1/task/result' \
-H 'Authorization: Bearer <your-api-key>' \
-H 'Content-Type: application/json' \
-d '{"task_id": "task-0192xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"}'处理中响应示例：
{
"status": "SUBMITTED",
"result": []
}成功响应示例：
{
"status": "SUCCEEDED",
"costUSD": 0.0123,
"result": [
{
"type": "Image",
"url": "https://cdn.example.com/generated/xxx.png",
"download_url": "https://cdn.example.com/generated/xxx.png?download=1"
}
]
}