MeToken AI 接口文档

通过浏览器会话管理账户，通过 Bearer Token 调用 Seedance 2.0 生成接口。所有生产请求由 MeToken AI 转发到 BytePlus 东南亚区域。

1. 用户注册与登录

注册和登录使用 HttpOnly Cookie 会话，并且必须先完成一次随机安全验证。安全验证会随机返回图形验证码或滑块验证，挑战绑定请求 IP、5 分钟过期且只能提交一次。

获取安全验证

{
  "id": "ach_xxxxxxxxxx",
  "type": "image",
  "image": "data:image/svg+xml;base64,...",
  "expires_in": 300
}

注册普通用户

{
  "name": "Example User",
  "email": "user@example.com",
  "password": "a-strong-password",
  "challengeId": "ach_xxxxxxxxxx",
  "challengeAnswer": "73529"
}

密码长度必须为 6～128 位。注册成功返回 HTTP 201、写入会话 Cookie，并创建普通用户账户；初始 USD 余额由平台配置决定。

登录账户

{
  "email": "user@example.com",
  "password": "a-strong-password",
  "remember": true,
  "challengeId": "ach_xxxxxxxxxx",
  "challengeAnswer": "73529"
}

登录成功后返回 HTTP 200，并通过 Set-Cookie 写入会话。设置 remember=true 时会话最长保留 30 天，否则默认保留 12 小时。

2. API Key 身份认证

生成 API 使用 Bearer Token，而不是登录密码或安全验证码。服务器保存用于鉴权的不可逆哈希和 AES-GCM 加密副本；登录用户可在控制台按需复制自己的密钥。

Authorization: Bearer YOUR_MEAPI_API_KEY

3. 创建视频任务

创建成功返回 HTTP 202 和 MeToken AI 平台任务 ID。Prompt 与参考媒体不能同时为空；model 必须使用管理员已启用的公开模型标识。实时模型清单可从 OpenAPI 文档获取。

{
  "model": "seedance-2-0-mini",
  "prompt": "A slow push-in shot through a neon street on a rainy night",
  "duration": 8,
  "resolution": "1080p",
  "ratio": "16:9",
  "generate_audio": true,
  "input_mode": "mixed",
  "media": [
    { "type": "image", "url": "https://cdn.example.com/reference.jpg" },
    { "type": "video", "url": "https://cdn.example.com/reference.mp4" },
    { "type": "audio", "url": "https://cdn.example.com/reference.mp3" }
  ]
}

调用与返回 Demo

curl --request POST "https://meapi.rkit88.org/api/v1/tasks" \
  --header "Authorization: Bearer YOUR_MEAPI_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "seedance-2-0-mini",
  "prompt": "A cinematic city at night",
  "duration": 8,
  "resolution": "1080p",
  "ratio": "16:9",
  "generate_audio": true
}'

{
  "id": "task_01JZ8Y7K4M2N6P9Q",
  "object": "video.generation.task",
  "model": "seedance-2-0-mini",
  "status": "queued",
  "created_at": "2026-07-25T10:30:00.000Z",
  "billing": {
    "currency": "USD",
    "reserved_usd": "0.061600"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "请求参数无效",
    "request_id": "req_01JZ8Y8A6N3F"
  }
}

使用本地文件创建任务

平台没有独立的文件上传接口。本地文件必须随 POST /api/v1/tasks 一次提交：请求使用 multipart/form-data，一个 request 文本字段传递任务 JSON，一个或多个同名 media 文件字段传递参考媒体。

curl -X POST "https://api.example.com/api/v1/tasks" \
  -H "Authorization: Bearer YOUR_MEAPI_API_KEY" \
  -F 'request={"model":"seedance-2-0-mini","prompt":"Cinematic city at night","duration":8,"resolution":"1080p","ratio":"16:9","generate_audio":true}' \
  -F 'media=@reference.jpg' \
  -F 'media=@reference.mp4' \
  -F 'media=@reference.mp3'

服务器在同一次请求中把所有媒体流式上传到 Cloudflare R2，不写入服务器本地磁盘；随后把 R2 临时访问链接导入当前用户专属的 BytePlus AIGC 素材资产组，等待素材变为 Active 后以 asset://<asset_id> 引用创建任务。用户首次使用时会自动创建资产组。

4. 生成与编辑图片

图片接口使用同步 JSON 响应，支持纯文本生成、单图编辑和多图融合。参考图片可使用公网 HTTPS URL 或 data:image/...;base64，每张不超过 30 MB。每次调用都会写入任务记录，并根据锁定的图片模型价格完成 USD 预扣与结算。

{
  "model": "Dola-Seedream-5.0-pro",
  "prompt": "Create a cinematic product photograph with soft studio lighting",
  "image": [
    "https://cdn.example.com/reference-1.png",
    "data:image/jpeg;base64,..."
  ],
  "size": "2K",
  "response_format": "url",
  "output_format": "png",
  "watermark": false
}

调用与返回 Demo

curl --request POST "https://meapi.rkit88.org/api/v1/images/generations" \
  --header "Authorization: Bearer YOUR_MEAPI_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "Dola-Seedream-5.0-pro",
  "prompt": "A cinematic product photograph with soft studio lighting",
  "size": "2K",
  "response_format": "url",
  "output_format": "png",
  "watermark": false
}'

{
  "created": 1784975400,
  "data": [
    {
      "url": "https://example.com/generated/image.png",
      "size": "2048x2048"
    }
  ],
  "task_id": "task_01JZ8Z1H6K4P",
  "usage": {
    "input_images": 0,
    "output_images": 1
  },
  "billing": {
    "currency": "USD",
    "actual_usd": "0.090000"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "请求参数无效",
    "request_id": "req_01JZ8Y8A6N3F"
  }
}

图片生成接口当前仅提供非流式响应。Pro 不接受 sequential_image_generation；Lite 与 4.5 开启序列出图时可通过 sequential_image_generation_options.max_images 设置最大输出数量。

5. 语言模型 Chat Completions

接口兼容常用的 OpenAI Chat Completions JSON 结构，支持普通 JSON 响应和流式 SSE。MeToken AI 只替换公开模型名称，其他官方参数会透明转发到 BytePlus；API Key 必须包含 language:create 权限。

{
  "model": "Dola-Seed-2.0-mini",
  "messages": [
    { "role": "system", "content": "You are a concise technical assistant." },
    { "role": "user", "content": "Explain how token-based billing works." }
  ],
  "thinking": { "type": "enabled" },
  "max_completion_tokens": 4096,
  "stream": false
}

调用与返回 Demo

curl --request POST "https://meapi.rkit88.org/api/v1/chat/completions" \
  --header "Authorization: Bearer YOUR_MEAPI_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "Dola-Seed-2.0-mini",
  "messages": [
    {
      "role": "user",
      "content": "Explain token billing in one paragraph."
    }
  ],
  "stream": false,
  "max_completion_tokens": 1024
}'

{
  "id": "chatcmpl_01JZ90A8",
  "object": "chat.completion",
  "model": "Dola-Seed-2.0-mini",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Token billing charges input and output usage separately."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 18,
    "completion_tokens": 14,
    "total_tokens": 32
  },
  "billing": {
    "currency": "USD",
    "actual_usd": "0.000040"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "请求参数无效",
    "request_id": "req_01JZ8Y8A6N3F"
  }
}

流式请求会自动设置 stream_options.include_usage=true，响应保持 text/event-stream，并通过 X-MeAPI-Task-Id 返回平台任务 ID。平台使用官方 usage 中的输入、输出、缓存命中和语音缓存命中 Token 完成 USD 结算。

多模态消息可按官方结构传入 HTTPS URL、Base64 或已有的 BytePlus file_id。Chat Completions 媒体直接交给模型理解，不进入 Seedance 视频任务的 R2 素材资产组链路。

6. Seed Audio 语音生成

Seed-Audio-1.0 使用 BytePlus Voice 独立的 X-Api-Key，提供非流式 HTTP 生成。API Key 必须包含 audio:create 权限；text_prompt 最长 3000 个字符。

{
  "model": "Seed-Audio-1.0",
  "text_prompt": "Warm documentary narration: Welcome to our new world.",
  "references": [
    { "audio_url": "https://cdn.example.com/reference.mp3" }
  ],
  "audio_config": {
    "format": "mp3",
    "sample_rate": 44100,
    "enable_subtitle": true
  }
}

调用与返回 Demo

curl --request POST "https://meapi.rkit88.org/api/v1/audio/generations" \
  --header "Authorization: Bearer YOUR_MEAPI_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "Seed-Audio-1.0",
  "text_prompt": "Warm documentary narration: Welcome to our new world.",
  "audio_config": {
    "format": "mp3",
    "sample_rate": 44100,
    "enable_subtitle": true
  }
}'

{
  "task_id": "task_01JZ91F2",
  "model": "Seed-Audio-1.0",
  "audio": {
    "format": "mp3",
    "data": "base64_encoded_audio...",
    "url": "https://example.com/generated/audio.mp3"
  },
  "duration": 4.8,
  "subtitles": [
    {
      "start_time": 0,
      "end_time": 4.8,
      "text": "Welcome to our new world."
    }
  ],
  "billing": {
    "currency": "USD",
    "actual_usd": "0.012000"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "请求参数无效",
    "request_id": "req_01JZ8Y8A6N3F"
  }
}

成功响应包含音频 Base64、供应商临时下载 URL、实际时长、原始计费时长、可选字幕、MeToken AI 任务 ID 和 USD 账单信息。供应商 URL 仅用于临时下载，需要长期保存时请及时转存。

7. 媒体格式与数量限制

音频不能单独作为参考，至少还需要一张图片或一个视频。无论来源是本地文件还是链接，平台都会先复制到 R2，再导入用户自己的 BytePlus 资产组。

8. 查询与取消任务

任务列表支持分页。page_size 可选 20、50 或 100；status 可传 running、completed 或具体任务状态。普通用户只能查询自己的任务。

查询接口返回统一任务状态、USD 结算信息、价格版本和生成结果地址。只有尚未开始运行的任务可以取消；无法取消时返回 HTTP 409。

9. USD 计费

1. 每个模型拥有独立、带版本的 USD 价格配置，任务创建时锁定价格快照。
2. 请求先通过权限、美元余额和并发检查，并根据生成规格预扣预计金额。
3. 供应商任务完成后按官方实际用量和锁定价格结算。
4. 多预扣部分自动释放；失败或超时自动退款并写入不可变账本。

10. 任务状态同步

平台优先接收 BytePlus 官方回调，后台维护循环按计划轮询兜底并对失败请求指数退避。上游任务 ID 不会暴露给普通用户。

11. 错误处理