快速开始

本指南帮助你在约 5 分钟内完成：注册 → 创建 API Key → 调用第一个 Chat 接口。

---

前置条件

• 可访问 JELLYTOKEN 控制台（www.jellytoken.com↗）
• 可访问推理 API（aiservice.jellytoken.com↗）

---

步骤 1：注册并登录

1. 打开 注册页（完整地址：https://www.jellytoken.com/auth/register↗）
2. 输入手机号，完成图形验证码，获取短信验证码
3. 勾选用户协议，完成注册
4. 登录后默认进入 模型超市

详见 控制台使用指南 · 账号。

---

步骤 2：创建 API Key

1. 进入 密钥管理
2. 点击「创建密钥」，填写备注（必填，≤30 字）
3. 创建成功后立即复制完整密钥（格式 uas_...），仅展示一次
4. 妥善保存；后续复制完整 Key 需短信验证

每个账号最多 20 个 Key；禁用状态的 Key 无法调用 API。

---

步骤 3：查看可用模型

方式 A：控制台

• 打开 模型超市 或 模型广场，点击模型卡片查看详情
• 复制 模型 ID，例如 qwen-plus

方式 B：API

curl -s https://aiservice.jellytoken.com/v1/models \
  -H "Authorization: Bearer uas_你的密钥"

---

步骤 4：发起 Chat 请求

cURL

export API_KEY="uas_你的密钥"
export API_BASE_URL="https://aiservice.jellytoken.com"

curl -s "${API_BASE_URL}/v1/chat/completions" \
  -H "Authorization: Bearer ${API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen-plus",
    "messages": [
      {"role": "user", "content": "用一句话介绍 JELLYTOKEN"}
    ]
  }'

Python（OpenAI SDK）

from openai import OpenAI

client = OpenAI(
    api_key="uas_你的密钥",
    base_url="https://aiservice.jellytoken.com/v1",
)

response = client.chat.completions.create(
    model="qwen-plus",
    messages=[{"role": "user", "content": "Hello"}],
)
print(response.choices[0].message.content)

流式

stream = client.chat.completions.create(
    model="qwen-plus",
    messages=[{"role": "user", "content": "写一首短诗"}],
    stream=True,
)
for chunk in stream:
    delta = chunk.choices[0].delta.content
    if delta:
        print(delta, end="", flush=True)

---

可选：文生图（异步任务）

若账号已授权图片模型，可在完成 Chat 调用后继续体验异步任务 API。只需替换 API_KEY，modelKey 使用控制台复制的模型 ID（如 qwen-image-plus）：

export API_KEY="uas_你的密钥"
export API_BASE_URL="https://aiservice.jellytoken.com"

TASK=$(curl -s -X POST "$API_BASE_URL/api/ai/tasks" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "modelKey": "qwen-image-plus",
    "callbackId": "demo-image-001",
    "imageParams": {
      "prompt": "一只可爱的机器人，干净背景",
      "aspectRatio": "1:1",
      "resolution": "2k"
    }
  }')
echo "$TASK"

TASK_ID=$(echo "$TASK" | jq -r .taskId)
curl -s "$API_BASE_URL/api/ai/tasks/$TASK_ID" \
  -H "Authorization: Bearer $API_KEY" | jq .

status 为 completed 时，从响应中的 resultUrlPublic 获取图片地址。完整说明见 异步任务。

---

步骤 5：查看用量（可选）

登录控制台 → 数据统计，查看调用量汇总（数据每日更新）。

---

下一步

---

常见问题

Q：model_not_found 或 access_denied？

• 确认 model 填的是 模型 ID（与控制台复制值、OpenAI 兼容接口的 model 参数相同）
• 确认账号已对该模型授权（未上架或未授权的模型不可调用）

Q：控制台创建的 Key 和 API 域名关系？

• Key 在控制台创建，调用地址是推理 API 域名（如 aiservice.jellytoken.com），不是控制台域名。