控制台

快速开始

从注册账户到完成首次 API 调用的完整接入指南

快速开始

本指南将引导你完成 iCreat 平台接入的前置流程：注册账户、充值额度、创建 API Key，并通过 cURL 发起首次 API 请求。按步骤操作，通常可在 5 分钟内 完成首次调用。

前置条件

  • 可正常访问 https://api.icreat.ai 的网络环境
  • 终端环境（macOS / Linux / Windows PowerShell 均可）
  • 可选：安装 cURL 与 jq，便于发送请求与解析 JSON 响应

第一步：注册账户

访问 iCreat AI 使用以下两种方式之一注册：

方式一：Google 快捷登录

  1. 点击「Google 登录」按钮
  2. 使用 Google 账户授权
  3. 自动创建账户，立即可用

方式二：邮箱注册

前往 注册页面 创建 iCreat 账户：

  1. 填写用户名与邮箱地址
  2. 设置登录密码（8–20 位字符）
  3. 点击「获取验证码」，输入邮箱收到的验证码（若未收到，请检查垃圾邮件文件夹）
  4. 提交并完成注册

已有账户？直接 登录 进入控制台。

安全建议

请使用强密码并妥善保管登录凭证，切勿与他人共享账户信息。

第二步：充值额度

iCreat 采用 预付费额度 计费模式，API 调用将从账户余额中扣除相应费用。

登录控制台后，进入 钱包 页面完成充值：

  • 不同模型的单次调用费用不同，详见 模型广场
  • 余额不足时，API 将返回错误并拒绝请求，请及时充值
  • 可在控制台查看实时余额与历史消费记录

计费说明

每次 API 调用的费用会实时写入使用日志，支持按 Key、按模型维度查询明细。

第三步：创建 API Key

API Key 是调用 iCreat API 的身份凭证，通过 HTTP Header 中的 Authorization: Bearer <API_KEY> 传递。

在 API Keys 页面创建密钥：

  1. 点击「添加」
  2. 填写密钥名称（建议按用途命名，如 production-backend、local-dev）
  3. 可选：设置额度上限与过期时间，便于权限隔离与成本控制
  4. 提交创建

安全须知

  • 密钥 仅在创建时完整显示一次，请立即复制并存储至安全位置（如密钥管理服务或环境变量）
  • 禁止将 API Key 写入前端代码或提交至公开代码仓库
  • 若密钥泄露，请立即在控制台吊销并重新创建
  • 建议为不同环境、不同应用分别创建独立 Key，便于审计与轮换

更多细节请参阅 API Key 管理。

第四步：发起首次 API 调用

iCreat 的图像、视频等生成类接口采用 异步任务 模式，标准调用流程为：

提交任务 → 轮询状态 → 获取结果

以下以 GPT-Image-2 文生图为例，演示完整的三段式调用。请将 <your-api-key> 替换为上一步创建的密钥。

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/query-status

curl -X POST 'https://api.icreat.ai/v1/task/query-status' \
  -H 'Authorization: Bearer <your-api-key>' \
  -H 'Content-Type: application/json' \
  -d '{"task_id": "task-0192xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"}'

当 status 为 SUCCEEDED 时，即可拉取生成结果。任务处理中可能返回 IN_PROGRESS，请间隔数秒后重试。

4.3 获取生成结果

POST https://api.icreat.ai/v1/task/get-result

curl -X POST 'https://api.icreat.ai/v1/task/get-result' \
  -H 'Authorization: Bearer <your-api-key>' \
  -H 'Content-Type: application/json' \
  -d '{"task_id": "task-0192xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"}'

响应示例：

[
  {
    "type": "Image",
    "url": "https://cdn.example.com/generated/xxx.png"
  }
]

返回的 url 即为生成图像的访问地址。

下一步

  • API 手册 — 浏览 LLM、图片与视频模型 API 文档
  • 集成指南 — 将 iCreat 接入 Claude Code、Codex 等开发工具