API Documentation

接入文档

OpenAI 兼容 REST API，一套凭证调用全部模型。智能渠道路由、透明计费、完整代码示例，助您快速完成业务接入。

统一 API 基址

https://ai1349.com/v1

Bearer 平台 API Key

Authorization: Bearer sk-xxx

在线模型

55OpenAI 协议兼容

接入总览

1349 AI hub 提供与 OpenAI 完全兼容的 REST API。您只需将 base_url 替换为平台统一网关地址，并使用平台签发的 API Key 完成鉴权，即可调用 GPT、Claude、Gemini、DeepSeek、Kimi、豆包等国内外主流大模型。

平台在您与上游模型厂商之间构建了一层统一调度网关：按模型自动选择最优上游渠道与协议适配器（Claude 走 Messages，其它走 Chat Completions）、同层负载均衡、失败自动重试与降级。您无需关心任何上游细节，渠道由平台统一维护。

一套凭证

创建 API Key 即可调用全部模型，无需为每个厂商单独申请密钥

统一协议

OpenAI 兼容接口，官方 SDK 改一行 base_url 即可接入

智能调度

多上游渠道负载均衡、自动故障切换与降级重试

透明计费

按 Token 实时计费，用量日志与账单明细实时可查

快速开始

最快 3 分钟完成接入，4 步即可发起首次调用

1
注册账户
免费注册1349 AI hub 账号并登录控制台。
进入控制台 →
2
充值余额
为账户充值，获得调用模型的可用额度。
进入控制台 →
3
创建 API Key
在「令牌管理」中创建以 sk- 开头的平台密钥。
创建 API Key →
4
发起首次调用
将下方代码中的 base_url 与 key 替换为平台配置，即可调用。
代码示例 →

客户端 / IDE 配置

Cherry Studio、Trae、Cursor 等请始终选 OpenAI Chat Completions（base_url 填到 /v1）。Claude 不要改选 Anthropic 协议：客户端仍走 /v1/chat/completions，平台按模型自动转 Bedrock Messages。

Trae CN 完整配置

配置前请确认

已在平台注册并登录，账户余额 > 0（否则返回 402）。
已在「令牌管理」创建 sk- 开头的 API Key，并妥善保存。
目标模型已在平台「模型管理」上架且状态为启用（如 anthropic.claude-opus-5、deepseek.v3.2）。
API 格式选 OpenAI Chat Completions；模型 ID 必须与平台 model_code 完全一致。

配置步骤

1打开 Trae CN → 左下角头像 / 设置 →「模型」，点击「添加模型」或已有模型的「编辑」。
2在弹窗顶部切换到「自定义配置」标签（⚠️ 不要选「模型服务商」）。
3按下方「字段对照表」逐项填写；请求地址填页顶 API 基址，密钥填平台 sk- Key。
4「完整 URL」保持关闭；Trae 会自动在地址后追加 /chat/completions。
5点击「确认」保存，回到对话窗口在模型下拉框中选择刚配置的模型。
6建议先发一句简单消息（如「你好」）验证连通，再开始复杂任务。

字段对照表（与截图一一对应）

Trae 字段	填写说明
API 格式	OpenAI Chat Completions 格式
自定义请求地址	https://ai1349.com/v1 · 不要以斜杠结尾
完整 URL（开关）	关闭。开启后需自行填写含 /chat/completions 的完整路径，容易配错
模型 ID	与平台 model_code 完全一致，例如 anthropic.claude-opus-5、deepseek.v3.2
API 密钥	控制台「令牌管理」创建的 sk- 密钥（不是登录密码）
多模态（开关）	纯代码对话建议关闭；仅在使用识图等能力时开启

Trae CN 编辑模型 · 自定义配置：OpenAI 格式、https://mcai.store/v1、模型 ID 与 API Key — 图：Trae CN「编辑模型 → 自定义配置」完整示例（纯对话建议关闭多模态）

先用 cURL 验证（排除 Trae 自身问题）

若 Trae 中途断开，请先在终端执行以下命令。能正常流式输出说明平台与密钥无误，问题在 Trae 客户端或本地网络。

cURL · stream

curl https://ai1349.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的APIKey" \
  -d '{
    "model": "anthropic.claude-opus-5",
    "stream": true,
    "messages": [
      {"role": "user", "content": "用三句话介绍你自己"}
    ]
  }'

创建 API Key →模型列表 →

常见问题 · 回复中途断开 / 思考未完成就停止

Trae CN 对流式 SSE 格式较敏感。以下按出现频率排序，请逐项排查：

模型 ID 填错或未上架
平台会返回 400「模型不可用」。请在「模型列表」复制准确的 model_code，区分大小写与连字符。
余额不足或密钥无效
分别返回 402 / 401。控制台查看余额与令牌状态，确认 sk- Key 未过期、未禁用。
推理模型「思考中」长时间无输出后断开
DeepSeek 等推理模型可能数十秒才输出首个 token。Trae 或本地代理若超时较短会主动断开。建议：新建对话重试、关闭系统代理对 mcai.store 的干扰、换非推理模型（如 deepseek-v4-flash）对比测试。
旧对话上下文损坏
流式中断后同一会话可能持续异常。点击 Trae 顶部「新建对话」清空上下文后再试。
Trae 流式解析兼容性（992 / 空白回复）
Trae 社区反馈：部分中转返回的空 delta chunk 会导致客户端提前停止解析。若 cURL 正常但 Trae 空白，属 Trae 客户端兼容问题，可尝试更新 Trae 或通过「帮助 → 报告问题」提交日志。
Agent 模式思考到一半就「任务完成」（已修复）
Trae Agent 会发送 tools、tool_calls、tool 角色消息。旧版中转若裁剪这些字段，Agent 会在约 10%～20% 进度提前结束；官方 API 直连则正常。平台已改为完整透传请求体，部署后请新建对话重试。
客户端选了 Anthropic 协议导致连不上
Cherry Studio / Trae 调用 Claude 时仍选 OpenAI Chat Completions，模型填 anthropic.claude-opus-5。不要选 Anthropic Messages 或把地址改成 /anthropic/v1/messages——那是上游协议，由平台自动适配。

鉴权认证

所有 API 请求都需要在 Authorization 请求头中携带平台 API Key（Bearer Token），格式如下：

鉴权方式

Authorization: Bearer sk-xxxxxxxxxxxxxxxx

API Key 在控制台「令牌管理」中创建，格式为 sk- 开头；
密钥仅创建时展示一次，请妥善保管，切勿泄露给他人；
调用按输入输出 Token 实时计费，余额不足时请求会被拒绝（402）。

统一接口 · Chat Completions

平台核心对话接口，完全兼容 OpenAI chat/completions 协议，支持流式（SSE）与非流式两种模式，默认开启流式。

Method	Endpoint	接口说明
POST	https://ai1349.com/v1/chat/completions	对话补全（兼容 OpenAI），支持流式与非流式
POST	https://ai1349.com/v1/images/generations	图像生成（兼容 OpenAI Images）
POST	https://ai1349.com/v1/audio/speech	语音合成 TTS（兼容 OpenAI Audio）
POST	https://ai1349.com/v1/audio/transcriptions	语音识别 ASR（兼容 OpenAI Audio）
POST	https://ai1349.com/v1/embeddings	向量嵌入（兼容 OpenAI Embeddings）
POST	https://ai1349.com/v1/video/generations	视频生成（文本生视频）
GET	https://ai1349.com/v1/models	查询当前在线的模型列表

为什么是「统一接口」？

平台聚合多个上游厂商，对外只暴露一套 OpenAI 兼容协议。您传入模型 Code 后，平台会自动路由到最优上游渠道、按模型选择协议适配器（鉴权、转发、计费），后续新增上游或调整渠道均不影响您的代码。

协议适配（客户端无需改格式）

Cherry Studio、Trae、Cursor 等请始终使用 OpenAI Chat Completions（base_url 填到 /v1，关闭「完整 URL」）。平台按模型自动适配上游：Claude / anthropic.* 走 Amazon Bedrock Anthropic Messages（/anthropic/v1/messages），再转回 OpenAI 的 JSON 与 SSE；DeepSeek、Kimi、Qwen 等仍直转 Chat Completions。tools / 流式 / 计费字段对外保持 OpenAI 形态。

多模态接口

除对话补全外，平台还提供图像生成、语音合成、语音识别、向量嵌入与视频生成五类多模态接口，全部兼容 OpenAI 协议，使用同一套 API Key 鉴权，按次/按 Token 实时计费。

POST https://ai1349.com/v1/images/generations图像生成 · Image Generation

根据文本提示词生成图像，支持批量生成与多种尺寸，返回图片 URL（默认）或 base64。

cURL

curl https://ai1349.com/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的APIKey" \
  -d '{
    "model": "doubao-seedream-5-0",
    "prompt": "一只戴着宇航员头盔的橘猫，赛博朋克风格",
    "n": 1,
    "size": "1024x1024"
  }'

参数：model（必填，图像模型 Code，如 doubao-seedream-5-0）；prompt（必填，提示词）；n（可选，生成数量 1-4，默认 1）；size（可选，默认 1024x1024）；response_format（可选，url 或 b64_json）。

POST https://ai1349.com/v1/audio/speech语音合成 · Text-to-Speech

将文本合成为自然流畅的语音，支持多种音色、输出格式与语速调节，直接返回音频文件流。

cURL

curl https://ai1349.com/v1/audio/speech \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的APIKey" \
  -d '{
    "model": "doubao-tts",
    "input": "你好，欢迎使用聚合 AI 平台",
    "voice": "zh_female_xiaohe_uranus_bigtts",
    "response_format": "mp3",
    "speed": 1.0
  }' --output speech.mp3

参数：model（必填，TTS 模型 Code）；input（必填，待合成文本）；voice（可选，音色，默认 zh_female_xiaohe_uranus_bigtts）；response_format（可选，mp3/ogg_opus/pcm，默认 mp3）；speed（可选，语速）。

POST https://ai1349.com/v1/audio/transcriptions语音识别 · Speech-to-Text

将上传的音频文件转录为文本，支持多种输出格式，适合语音转写、字幕生成等场景。

cURL

curl https://ai1349.com/v1/audio/transcriptions \
  -H "Authorization: Bearer sk-你的APIKey" \
  -F "file=@audio.mp3" \
  -F "model=doubao-asr" \
  -F "response_format=json"

请求体为 multipart/form-data：file（必填，音频文件）；model（必填，ASR 模型 Code）；response_format（可选，json/text/srt/verbose_json/vtt，默认 json）。

POST https://ai1349.com/v1/embeddings向量嵌入 · Embeddings

将文本转换为高维向量表示，支持批量输入与多种编码格式，适用于语义检索、聚类、RAG 等场景。

cURL

curl https://ai1349.com/v1/embeddings \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的APIKey" \
  -d '{
    "model": "doubao-embedding",
    "input": ["深度学习", "向量检索"]
  }'

参数：model（必填，向量模型 Code）；input（必填，文本或文本数组）；encoding_format（可选，float 或 base64）。

POST https://ai1349.com/v1/video/generations视频生成 · Video Generation

根据文本提示词生成短视频，支持时长、分辨率与画面比例控制，返回视频文件 URL。

cURL

curl https://ai1349.com/v1/video/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的APIKey" \
  -d '{
    "model": "doubao-seedance-2-0",
    "prompt": "一只猫在夕阳下的海滩上奔跑",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

参数：model（必填，视频模型 Code，如 doubao-seedance-2-0）；prompt（必填，提示词）；duration（可选，时长秒）；resolution（可选，480p/720p/1080p）；aspect_ratio（可选，16:9/9:16/1:1 等）。

代码示例

以下示例演示了最常用的非流式与流式调用，替换为自己的 API Key 即可运行。

非流式 · cURL

cURL

curl https://ai1349.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的APIKey" \
  -d '{
    "model": "anthropic.claude-opus-5",
    "messages": [
      {"role": "user", "content": "你好，介绍一下你自己"}
    ]
  }'

流式 · cURL

cURL · stream

curl https://ai1349.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的APIKey" \
  -d '{
    "model": "anthropic.claude-opus-5",
    "stream": true,
    "messages": [
      {"role": "user", "content": "用三句话介绍你自己"}
    ]
  }'

Python · OpenAI SDK

Python

from openai import OpenAI

# 仅需修改 base_url 与 api_key，其余用法与官方 SDK 完全一致
client = OpenAI(
    api_key="sk-你的APIKey",
    base_url="https://ai1349.com/v1",
)

resp = client.chat.completions.create(
    model="anthropic.claude-opus-5",
    messages=[{"role": "user", "content": "你好"}],
    stream=True,
)

for chunk in resp:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Node.js · OpenAI SDK

Node.js

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-你的APIKey",
  baseURL: "https://ai1349.com/v1",
});

const stream = await client.chat.completions.create({
  model: "anthropic.claude-opus-5",
  messages: [{ role: "user", content: "你好" }],
  stream: true,
});

for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}

提示：官方 OpenAI SDK 原生支持本协议，除 base_url / api_key 外无需任何额外配置；流式响应可通过 SDK 的 stream 参数直接消费。

模型列表

以下为平台当前在线的模型目录（实时同步），请求体中的 model 字段直接使用「模型 Code」。

模型 Code	说明	上下文窗口	类型
`mistral.ministral-3-3b-instruct`	Amazon Bedrock (us-east-1)	128K	对话
`deepseek.v3.1`	Amazon Bedrock (us-east-1)	66K	对话
`anthropic.claude-opus-5`	Amazon Bedrock (us-east-1)	128K	对话
`deepseek.v3.2`	Amazon Bedrock (us-east-1)	66K	对话
`zai.glm-5`	Amazon Bedrock (us-east-1)	128K	对话
`qwen.qwen3-vl-235b-a22b-instruct`	Amazon Bedrock (us-east-1)	128K	对话
`mistral.ministral-3-14b-instruct`	Amazon Bedrock (us-east-1)	128K	对话
`mistral.devstral-2-123b`	Amazon Bedrock (us-east-1)	128K	对话
`qwen.qwen3-coder-30b-a3b-instruct`	Amazon Bedrock (us-east-1)	128K	对话
`zai.glm-4.7`	Amazon Bedrock (us-east-1)	128K	对话
`mistral.voxtral-mini-3b-2507`	Amazon Bedrock (us-east-1)	128K	对话
`openai.gpt-5.4`	Amazon Bedrock (us-east-1)	128K	对话
`nvidia.nemotron-super-3-120b`	Amazon Bedrock (us-east-1)	128K	对话
`minimax.minimax-m2.1`	Amazon Bedrock (us-east-1)	128K	对话
`anthropic.claude-opus-4-7`	Amazon Bedrock (us-east-1)	128K	对话
`mistral.ministral-3-8b-instruct`	Amazon Bedrock (us-east-1)	128K	对话
`zai.glm-4.6`	Amazon Bedrock (us-east-1)	128K	对话
`nvidia.nemotron-nano-9b-v2`	Amazon Bedrock (us-east-1)	128K	对话
`qwen.qwen3-coder-480b-a35b-instruct`	Amazon Bedrock (us-east-1)	128K	对话
`mistral.mistral-large-3-675b-instruct`	Amazon Bedrock (us-east-1)	128K	对话
`openai.gpt-oss-120b`	Amazon Bedrock (us-east-1)	128K	对话
`google.gemma-3-4b-it`	Amazon Bedrock (us-east-1)	128K	对话
`minimax.minimax-m2.5`	Amazon Bedrock (us-east-1)	128K	对话
`minimax.minimax-m2`	Amazon Bedrock (us-east-1)	128K	对话
`openai.gpt-5.6-sol`	Amazon Bedrock (us-east-1)	128K	对话
`google.gemma-4-31b`	Amazon Bedrock (us-east-1)	128K	对话
`moonshotai.kimi-k2.5`	Amazon Bedrock (us-east-1)	128K	对话
`mistral.voxtral-small-24b-2507`	Amazon Bedrock (us-east-1)	128K	对话
`qwen.qwen3-coder-next`	Amazon Bedrock (us-east-1)	128K	对话
`nvidia.nemotron-nano-12b-v2`	Amazon Bedrock (us-east-1)	128K	对话
`anthropic.claude-sonnet-5`	Amazon Bedrock (us-east-1)	128K	对话
`qwen.qwen3-next-80b-a3b-instruct`	Amazon Bedrock (us-east-1)	128K	对话
`nvidia.nemotron-nano-3-30b`	Amazon Bedrock (us-east-1)	128K	对话
`anthropic.claude-fable-5`	Amazon Bedrock (us-east-1)	128K	对话
`zai.glm-4.7-flash`	Amazon Bedrock (us-east-1)	128K	对话
`openai.gpt-oss-20b`	Amazon Bedrock (us-east-1)	128K	对话
`openai.gpt-5.5-2026-04-23`	Amazon Bedrock (us-east-1)	128K	对话
`xai.grok-4.3`	Amazon Bedrock (us-east-1)	128K	对话
`anthropic.claude-haiku-4-5`	Amazon Bedrock (us-east-1)	128K	对话
`openai.gpt-oss-safeguard-120b`	Amazon Bedrock (us-east-1)	128K	对话
`openai.gpt-5.6-terra`	Amazon Bedrock (us-east-1)	128K	对话
`openai.gpt-5.5`	Amazon Bedrock (us-east-1)	128K	对话
`writer.palmyra-vision-7b`	Amazon Bedrock (us-east-1)	128K	对话
`google.gemma-3-12b-it`	Amazon Bedrock (us-east-1)	128K	对话
`moonshotai.kimi-k2-thinking`	Amazon Bedrock (us-east-1)	128K	对话
`google.gemma-4-e2b`	Amazon Bedrock (us-east-1)	128K	对话
`openai.gpt-5.6-luna`	Amazon Bedrock (us-east-1)	128K	对话
`openai.gpt-5.4-2026-03-05`	Amazon Bedrock (us-east-1)	128K	对话
`google.gemma-3-27b-it`	Amazon Bedrock (us-east-1)	128K	对话
`qwen.qwen3-32b`	Amazon Bedrock (us-east-1)	128K	对话
`google.gemma-4-26b-a4b`	Amazon Bedrock (us-east-1)	128K	对话
`anthropic.claude-opus-4-8`	Amazon Bedrock (us-east-1)	128K	对话
`openai.gpt-oss-safeguard-20b`	Amazon Bedrock (us-east-1)	128K	对话
`qwen.qwen3-235b-a22b-2507`	Amazon Bedrock (us-east-1)	128K	对话
`mistral.magistral-small-2509`	Amazon Bedrock (us-east-1)	128K	对话

错误码

平台采用 OpenAI 兼容的错误响应结构（{"error":{"message","type","code"}}），HTTP 状态码语义如下：

状态码	错误信息	含义与处理建议
`400`	invalid_request_error	请求参数错误或模型不可用，核对 model 与 messages 是否符合规范
`401`	invalid_api_key	缺少或无效的 API Key，检查 Authorization 头是否为 Bearer sk-xxx 格式
`402`	insufficient_quota	账户余额不足，前往控制台充值后重试
`404`	model_not_found	模型不存在或暂无可用渠道，联系客服开通对应模型
`429`	rate_limit_exceeded	请求过于频繁触发限流，降低并发或稍后重试
`500`	internal_server_error	平台内部错误，请稍后重试或提交工单
`503`	upstream_unavailable	上游渠道全部调用失败，平台已自动重试降级；仍失败请稍后再试

计费与限流

平台按 Token 用量实时计费，价格统一按人民币展示，具体单价见「模型价格」页。

计费方式

输入与输出 Token 分别计价，单价以模型价格页为准；用量日志与账单明细实时可查，余额永不过期。

限流策略

为保障整体服务稳定性，平台按令牌与账户设置并发与速率上限；如需更高配额，可联系客服或申请企业套餐。

计费示例

例如输入 1,000 Token、输出 500 Token，输入单价 ¥3/1M、输出单价 ¥15/1M：费用 = 1000÷1M×¥3 + 500÷1M×¥15 = ¥0.0105。

注意：流式响应按实际消耗的 Token 计费；非流式按完整响应计费。请勿在客户端对 usage 做二次计费。

常见问题

关于接入的常见疑问，更多问题请联系在线客服。

接入文档

接入总览

快速开始

客户端 / IDE 配置

Trae CN 完整配置

先用 cURL 验证（排除 Trae 自身问题）

常见问题 · 回复中途断开 / 思考未完成就停止

鉴权认证

统一接口 · Chat Completions

多模态接口

代码示例

模型列表

错误码

计费与限流

常见问题

需要为每个模型厂商单独申请 API Key 吗？

会存储我的请求内容与响应数据吗？

支持流式输出吗？

上游渠道故障了怎么办？

客户端选 OpenAI 格式能调用 Claude 吗？