Skip to content

聊天与语音 ​

OpenAI 兼容文本聊天 ​

使用 POST /v1/chat/completions,通过 ModelGo API Key 鉴权。模型为 enj-1-uncensored 和 chat-fast;不再提供 qwen-character。兼容范围是文本 Chat Completions,不代表支持 OpenAI 全部功能。

bash
curl https://api.modelgo.moneygo.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{"model":"chat-fast","messages":[{"role":"user","content":"Hello!"}],"max_tokens":256}'
json
{
  "id":"chatcmpl_example",
  "object":"chat.completion",
  "created":1792540800,
  "model":"chat-fast",
  "choices":[{"index":0,"message":{"role":"assistant","content":"Hello!","refusal":null},"logprobs":null,"finish_reason":"stop"}],
  "usage":{"prompt_tokens":10,"completion_tokens":3,"total_tokens":13}
}

模型与价格 ​

  • GET /v1/models:标准模型列表,只列出已配置密钥和价格的可用模型。
  • GET /v1/chat/catalog:两个模型的 ID、可用状态与输入/输出单价,单位为积分/百万 token。null 表示未定价,不能调用。
  • 公开价格表展示相同售价,由后台分别配置输入和输出价格,不再按请求次数或回复条数收费。

参数 ​

每次传入完整 messages;此接口不会自动添加历史消息或默认人物设定。

参数支持范围
modelenj-1-uncensored、chat-fast
messages1–1000 条;角色 system、developer、user、assistant
content字符串或文本片段数组:[{"type":"text","text":"Hello"}]
stream布尔值,默认 false
temperature / top_p0–2 / 0–1
max_tokens 或 max_completion_tokens整数 1–8192,不能同时传;默认 2048
stop字符串或 1–4 个字符串
presence_penalty / frequency_penalty−2–2
seed安全整数
n仅支持 1
stream_options{"include_usage":true},仅限 stream=true

不支持工具/函数调用、图片/音频输入、结构化输出、logprobs、多候选和 Responses API。未支持的字段直接拒绝,不会静默忽略。采样参数效果取决于模型;超大请求及超过模型上下文限制的请求可能被拒绝。

SDK 与流式输出 ​

python
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["MODELGO_API_KEY"],
    base_url="https://api.modelgo.moneygo.ai/v1",
    max_retries=0,
)
stream = client.chat.completions.create(
    model="chat-fast",
    messages=[{"role":"user","content":"Hello!"}],
    max_tokens=256,
    stream=True,
    stream_options={"include_usage":True},
)
for chunk in stream:
    if chunk.choices:
        print(chunk.choices[0].delta.content or "", end="", flush=True)
    if chunk.usage:
        print(chunk.usage)

使用标准 data-only SSE,通过 choices[0].delta.content 读取文本,成功以 data: [DONE] 结束。include_usage=true 时最后额外返回 choices=[] 的用量块,其他块 usage=null;不传则流中省略 usage,但计费仍按实际 usage。

流开始前返回 HTTP JSON 错误;开始后错误以 error 数据帧返回,不发送成功结束标记。收到部分文本不代表成功。结算前断开连接释放冻结,成功结算后断开不撤销费用。非流式上游超时 60 秒;流式连接/空闲超时 90 秒,总时限 180 秒。

Token 计费 ​

积分 = (prompt_tokens × 输入单价 + completion_tokens × 输出单价) / 1,000,000

两项相加后一次向上取整至 8 位小数。输入包含历史和系统提示词;缓存命中的输入仍使用输入单价;包含在 completion_tokens 中的推理 token 不重复收费。仅使用上游有效 usage,不以文字长度估算扣费,也不回退到按次计费。

调用前按保守输入额度和输出上限冻结积分,成功后按实际用量结算、退还差额。减小 max_tokens 可以降低冻结额度。失败、usage 缺失/非法或流中断会释放冻结。进程异常遗留的冻结在 10 分钟后自动回收。钱包流水备注包含 completion ID、模型和输入/输出数量;冻结和退款不是额外消费。聊天不进入图片/视频生成任务列表。

请求不具备幂等性,重试可能产生新的生成及费用。

错误 ​

json
{"error":{"message":"...","type":"invalid_request_error","param":null,"code":"invalid_request"}}

400 参数非法/不支持;401 密钥无效;402 余额不足以冻结;429 限流;503 模型未配置/不可用、上游失败或 usage 无效。沿用平台 API Key、IP 白名单和限流规则。

旧会话与语音 ​

保留旧 /v1/chat/messages 和会话管理接口,兼容已有客户,但改用两个新模型及 token 计费;可传 model 指定模型。保留历史消息,旧会话未保存新模型时使用后台默认模型。新接入请使用 Chat Completions。

Playground 仍维护会话历史和人物设定,它们计入输入 token;在聊天设置中选择模型。

语音识别保持不变:POST /v1/chat/transcribe 接收录音 data URI/base64(最大 10MB)。

语音合成(TTS) ​

支持 Speech Light (speech-light)、Speech Pro (speech-pro)、Speech Expressive (speech-expressive);旧 Qwen TTS 与 Cherry 等旧音色已停用。需要 ModelGo API Key,不能使用上游密钥。

GET /v1/speech/catalog 返回 speechModels、voices 和 defaultVoice。音色的 modelId 决定模型,调用时使用完整 voices[].id,不要将显示名称当作 ID。只有上游可用且本站已定价的模型音色可调用;price=-1 表示未配置价格。后台可设置默认音色,用户也可以在聊天设置中选择朗读模型与音色。

OpenAI SDK 兼容接口 ​

POST /v1/audio/speech 返回 MP3 二进制音频流,支持 model、input、voice、可选 response_format="mp3"。model 必须与音色所属模型匹配。暂不支持其他音频格式、speed、instructions 等参数,不支持整个 OpenAI Audio API。

python
import os
from openai import OpenAI

client = OpenAI(api_key=os.environ["MODELGO_API_KEY"], base_url="https://api.modelgo.moneygo.ai/v1")
# 先查询 /v1/speech/catalog,确认该音色可用。
with client.audio.speech.with_streaming_response.create(
    model="speech-light", voice="speech-light:af_alloy",
    input="Hello, welcome to ModelGo.", response_format="mp3",
) as response:
    response.stream_to_file("speech.mp3")

JSON 与流式接口 ​

POST /v1/chat/speech 接收 { "text":"Hello!", "voice":"speech-light:af_alloy" }。voice 可省略,使用本站默认可用音色。返回 {audio, voice, billing},其中 audio 为 MP3 data URI,billing 包含本站 credits、model、characters、price、unit="1000_characters" 和 character_counting="utf16_code_units"。

添加 "stream":true 返回连续的 audio/mpeg 字节流,不是 SSE 或 JSON。例如:

bash
curl --fail --no-buffer https://api.modelgo.moneygo.ai/v1/chat/speech \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{"text":"Hello!","voice":"speech-light:af_alloy","stream":true}' \
  --output speech.mp3

计费与限制 ​

  • 每次最多 2,000 个 UTF-16 单位;普通中文/英文字母计 1,😀 计 2。上游去除格式标记和动作描述后的实际字符数用于结算,不按请求次数或音频秒数收费。
  • 费用 = 实际计费字符数 × 本站每千字符单价 ÷ 1,000,合计向上保留 8 位小数。三种模型分别在后台定价,与文本聊天独立收费。
  • 提交时按原始文本预留积分,成功后按上游返回的实际字符数结算并释放差额;上游缺少有效用量、失败或结算前断连时退款。成功结算后断连不撤销费用。
  • 余额不足返回 402;未知或不匹配的音色/模型返回 400;上游不可用返回 503。流式已开始后的失败会中断连接,请丢弃不完整音频并核对钱包流水,HTTP 200 或收到首段不代表成功。
  • 流水记录音色所属模型、字符数及每千字符单价;预留 hold 不应与实际 charge 相加。直接重播已取得的音频不会收费,但重新调用合成接口会收费。
  • 本站不返回上游积分售价。目录和公开价格表展示本站配置的售价;旧的免费 Qwen 朗读已被本计费模式替代。
Copyright © 2026 ModelGo all rights reserved | Technology powered by MoneyGo.ai