狗子AI中转站接口文档

接口基础地址：https://api.gouziai.com

汇总平台全部可用API，包含Chat对话、向量嵌入、图文音视频生成、实时语音、第三方聚合平台等全品类接口，完全兼容OpenAI标准调用格式，支持主流开发框架。

---

快速开始

第一个 API 请求

替换下方 YOUR_API_KEY 为个人密钥，直接终端执行调用：

curl https://api.gouziai.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "model": "gpt-4o",
  "messages": [{"role": "user", "content": "Say this is a test!"}],
  "temperature": 0.7
}'

响应示例

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1677858242,
  "model": "gpt-4o",
  "usage": {
    "prompt_tokens": 13,
    "completion_tokens": 7,
    "total_tokens": 20
  },
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": "\n\nThis is a test!"
      },
      "finish_reason": "stop",
      "index": 0
    }
  ]
}

BASE_URL 可选地址

不同客户端适配不同地址，依次尝试即可：

https://api.gouziai.com
https://api.gouziai.com/v1
https://api.gouziai.com/v1/chat/completions

通用配置示例

{
  "base_url": "https://api.gouziai.com",
  "api_key": "your_token_here",
  "model": "selected_model_name"
}

---

Chat 聊天接口

聊天完成对象（非流式）

请求端点：POST /v1/chat/completions

参数说明

参数	类型	描述
id	string	聊天完成唯一标识符
choices	array	回复选项列表，支持多结果返回
created	integer	Unix时间戳（创建时间）
model	string	当前调用模型名称
system_fingerprint	string	模型后端配置指纹
object	string	固定为 chat.completion
usage	object	令牌消耗统计
prompt_tokens	integer	输入提示令牌数
completion_tokens	integer	生成回复令牌数
total_tokens	integer	总消耗令牌数

响应示例

{
  "id": "chatcmpl-123",
  "object": "chat.completion",
  "created": 1677652288,
  "model": "gpt-3.5-turbo-0613",
  "system_fingerprint": "fp_44709d6fcb",
  "choices": [{
    "index": 0,
    "message": {
      "role": "assistant",
      "content": "\n\nHello there, how may I assist you today?"
    },
    "finish_reason": "stop"
  }],
  "usage": {
    "prompt_tokens": 9,
    "completion_tokens": 12,
    "total_tokens": 21
  }
}

聊天流式块对象（stream=true）

开启流式返回后，以SSE分片实时推送回复内容

参数说明

参数	类型	描述
id	string	同次会话统一ID
choices	array	分片内容数组
created	integer	统一创建时间戳
model	string	调用模型
system_fingerprint	string	后端配置指纹
object	string	固定为 chat.completion.chunk

流式响应示例

data: {"id":"chatcmpl-123","object":"chat.completion.chunk","created":1694268190,"model":"gpt-3.5-turbo-0613","system_fingerprint":"fp_44709d6fcb","choices":[{"index":0,"delta":{"role":"assistant","content":""},"finish_reason":null}]}
data: {"id":"chatcmpl-123","object":"chat.completion.chunk","created":1694268190,"model":"gpt-3.5-turbo-0613","system_fingerprint":"fp_44709d6fcb","choices":[{"index":0,"delta":{"content":"Hello"},"finish_reason":null}]}
data: {"id":"chatcmpl-123","object":"chat.completion.chunk","created":1694268190,"model":"gpt-3.5-turbo-0613","system_fingerprint":"fp_44709d6fcb","choices":[{"index":0,"delta":{"content":"!"},"finish_reason":null}]}
data: {"id":"chatcmpl-123","object":"chat.completion.chunk","created":1694268190,"model":"gpt-3.5-turbo-0613","system_fingerprint":"fp_44709d6fcb","choices":[{"index":0,"delta":{},"finish_reason":"stop"}]}

Claude 兼容接口

所有Claude系列模型完全适配 /v1/chat/completions 标准接口，无需修改调用代码。

---

Responses API

OpenAI新一代核心API，融合对话能力与智能代理操作，适合智能化应用开发。

API 对比

特性	Responses API	Chat Completions API
定位	新一代代理型核心API	经典行业标准对话API
特点	简洁高效、支持自动化任务	极致稳定、生态成熟
内置工具	联网搜索、文件检索、电脑操作	无
推荐人群	新应用、智能代理开发	通用业务、传统AI场景

适用场景

• 实时网络信息检索问答
• 本地/云端文件智能分析
• 自动化计算机操作代理

---

Completions 自动补全接口

请求端点：POST /v1/completions

适用于文本续写、自动补全，流式/非流式响应结构统一。

参数说明

参数	类型	描述
id	string	任务唯一ID
choices	array	文本补全结果列表
created	integer	创建时间戳
model	string	调用模型
system_fingerprint	string	后端配置指纹
object	string	固定为 text_completion
usage	object	令牌统计

响应示例

{
  "id": "cmpl-uqkvlQyYK7bGYrRHQ0eXlWi7",
  "object": "text_completion",
  "created": 1589478378,
  "model": "gpt-3.5-turbo",
  "choices": [
    {
      "text": "\n\nThis is indeed a test",
      "index": 0,
      "logprobs": null,
      "finish_reason": "length"
    }
  ],
  "usage": {
    "prompt_tokens": 5,
    "completion_tokens": 7,
    "total_tokens": 12
  }
}

---

Embeddings 向量嵌入接口

请求端点：POST /v1/embeddings

将文本转为高维向量，用于知识库、语义检索、相似度匹配、RAG场景。

响应参数

参数	类型	描述
index	integer	文本对应向量索引
embedding	array	浮点向量数组
object	string	固定为 embedding

响应示例

{
  "object": "embedding",
  "embedding": [
    0.0023064255,
    -0.009327292,
    -0.0028842222
  ],
  "index": 0
}

支持模型

模型	最大输入	维度说明
text-embedding-3-small	8191	默认1536维
text-embedding-3-large	8191	默认3072维，支持自定义
text-embedding-ada-002	8191	经典1536维模型

---

图片生成接口

图像响应参数

参数	类型	描述
url	string	图片在线地址（默认格式）
b64_json	string	图片Base64编码（指定格式时返回）
revised_prompt	string	模型优化后的提示词

响应示例

{
  "url": "https://xxx.png",
  "revised_prompt": "高清写实猫咪插画"
}

DALL·E 系列接口

• 文生图：POST /v1/images/generations（支持DALL·E2/3）
• 图像编辑：POST /v1/images/edits（仅DALL·E2）
• 图像变体：POST /v1/images/variations（仅DALL·E2）

注意：上传图片需 ≤4MB、方形PNG格式。

gpt-image-1 模型

支持图片生成、图片编辑，复用上述端点。

---

视频生成接口

所有视频生成均为异步任务，创建任务后轮询/回调获取结果。

全平台任务状态码

Vidu

created    创建成功
queueing   排队中
processing 处理中
success    成功
failed     失败

VEO / Grok

pending                  等待中
image_downloading        图片下载中
video_generating         视频生成中
video_generation_completed 生成完成
video_generation_failed   生成失败
video_upsampling         超分中
video_upsampling_completed 超分完成
completed                完成
failed/error             异常

Luma

queued     排队
pending    等待
processing 处理
completed  完成
failed/error 失败

海螺MiniMax

Waiting  等待
Running  执行
Success  成功
Failed   失败
Cancelled 已取消

即梦

NOT_START   未开始
SUBMITTED   已提交
QUEUED      排队
IN_PROGRESS 执行中
FAILURE     失败
SUCCESS     成功

腾讯AIGC

WAITING    等待
PROCESSING 处理
FINISH     完成
ABORTED    终止

可灵Kling 回调协议

配置 callback_url 后，状态变更自动推送结果

状态枚举：submitted、processing、succeed、failed

回调格式

{
  "task_id": "string",
  "task_status": "string",
  "task_status_msg": "string",
  "created_at": 1722769557708,
  "updated_at": 1722769557708,
  "task_result": {
    "images": [{"index": 0, "url": "string"}],
    "videos": [{"id": "string", "url": "string", "duration": "string"}]
  }
}

---

Suno音乐生成接口

基础地址

• 提交任务：POST https://api.gouziai.com/suno/submit/music
• 查询结果：GET https://api.gouziai.com/suno/fetch

支持模型

模型	版本
chirp-v3-0	v3.0
chirp-v3-5	v3.5
chirp-v4	v4.0
chirp-auk	v4.5
chirp-v5	v5.0
chirp-fenix	v5.5

任务字段说明

字段	类型	描述
task_id	string	唯一任务ID
action	string	MUSIC/LYRICS 生成类型
status	string	任务状态
submitTime	number	提交时间戳
failReason	string	失败原因

生成参数

普通生成

参数	类型	说明
title	String	音乐标题
tags	String	风格标签，逗号分隔
prompt	String	创作提示词
mv	String	模型名称

音乐续写

参数：continue_at（续写秒数）、continue_clip_id（原音频ID）、task=extend

翻唱生成

参数：mv=chirp-v3-5-tau、task=cover、cover_clip_id（原曲ID）

---

语音接口

语音转文本Whisper

• 转录接口：POST /v1/audio/transcriptions
• 翻译接口：POST /v1/audio/translations
• 支持格式：mp3、mp4、wav、webm 等，最大25MB

文本转语音TTS

端点：POST /v1/audio/speech

模型	特点
tts-1	低延迟，实时场景
tts-1-hd	高清音质

可用音色：alloy、echo、fable、nova、shimmer、onyx

输出格式：MP3、Opus、AAC、FLAC、WAV、PCM

---

Realtime 实时语音接口

地址：wss://api.gouziai.com/v1/realtime

WebSocket协议，支持gpt-4o-realtime-preview实时对话

请求头

Authorization: Bearer YOUR_API_KEY
OpenAI-Beta: realtime=v1

---

Fal.ai 聚合平台

支持模型

支持flux系列全量画图模型，包含dev、schnell、pro/kontext等版本

请求规范

请求地址：POST https://api.gouziai.com/fal-ai/{model}

请求头：Authorization: Bearer YOUR_KEY

任务状态

IN_QUEUE    排队
IN_PROGRESS 执行中
COMPLETED   完成
FAILED      失败

---

Replicate 聚合平台

接入规则

官方域名 https://api.replicate.com 替换为 https://api.gouziai.com/replicate，参数完全兼容

核心字段

input（入参）、output（资源地址）、status（starting/processing/succeeded/failed）

注意：返回资源链接有效期1小时

---

渠道分组与费率说明

费率规则

• 费率=1：官方原价扣费
• 费率=1.65/3/6/8/12/16：渠道溢价扣费
• 费率=0.6：特价优惠扣费

分组详情

分组	类型	费率	支持模型
default默认	混合多渠道	1.0	OpenAI、Claude、国产模型
企业高可用	国产模型专属	1.0	DeepSeek、Qwen
优质grok	Grok专属	5.0	Grok全系
限时特价	综合优惠	0.6	国产、Gemini、GPT

---

HTTP 状态码说明

状态码	含义
400	请求参数错误
401	密钥无效/过期
403	权限不足
404	接口不存在
429	请求限流
500	服务内部错误
503	服务暂时不可用

---

文档更新时间：2026-06-30