POST /chat/completions 接口。你可以用同一个 AIOAGI API Key 调用控制台可用的 GPT、Claude、DeepSeek、Gemini、Qwen、Vibe Coding 等模型系列。
模型名称、可用范围、上下文长度、价格和支持策略可能变化。请以控制台和开发者指南显示的信息为准。
功能概述
文本生成接口适合以下场景:- 智能对话:构建客服助手、问答机器人和个人助理
- 内容创作:生成文章、摘要、标题、邮件和营销文案
- 代码辅助:生成代码、解释报错、重构片段和编写测试
- 知识问答:从输入内容中提取信息、归纳要点和生成结构化答案
- 角色设定:通过
system消息固定回复风格、身份和输出规则
快速开始
1
准备 API Key
在 AIOAGI 控制台创建 API Key,并确认 Token 组额度和模型权限可用。
2
配置基础地址
服务端调用时设置
base_url。大多数文本生成场景使用 https://api.aiearth.dev/v1。3
选择模型
在控制台或开发者指南中查看可用模型 ID。示例中的
gpt-4o-mini 仅用于演示。4
发送消息
使用
messages 数组传入 system、user 和 assistant 消息。基础对话示例
使用 OpenAI Python SDK 发起单轮文本生成请求:curl 请求:
多轮对话示例
多轮对话由应用层维护历史消息。每次请求时,把需要保留的上下文一起传入messages。
核心参数
string
required
模型 ID。请填写控制台当前可用的模型名称,例如 GPT、Claude、DeepSeek、Gemini、Qwen 或 Vibe Coding 系列模型。
array
required
对话消息数组。每条消息通常包含
role 和 content。number
控制输出随机性。常见范围为
0 到 2。数值越低,输出越稳定;数值越高,输出越发散。integer
限制最大输出长度。该参数可用于控制成本和响应长度。
boolean
是否启用流式输出。设置为
true 后,服务端会分块返回模型生成内容。messages 角色
role
定义模型的身份、目标、边界和输出格式。适合放置稳定规则。
role
用户输入。每次用户提问通常追加一条
user 消息。role
历史模型回复。多轮对话中可保留关键回复,帮助模型延续上下文。
流式输出
当你要提升前端体验或处理长文本生成时,可以启用stream。
高级用法
系统提示
通过system 消息约束模型的行为和输出格式:
角色设定
为不同任务设置稳定角色,可以提高输出一致性。上下文管理
长对话需要控制历史长度。你可以保留system 消息和最近几轮对话。
模型选择建议
最佳实践
优化提示词
把任务、背景、输出格式和限制写清楚。增加错误处理
生产环境应处理认证、额度、限流、模型不可用和网络异常。控制成本
- 为不同场景选择不同模型,不要所有任务都使用最高规格模型
- 使用
max_tokens控制单次输出长度 - 清理不必要的历史消息,避免重复传入长上下文
- 为不同应用创建独立 Token 组,便于统计和限额
- 定期查看控制台用量和余额
常见问题
如何计算 token 数量?
如何计算 token 数量?
你可以使用模型对应的 tokenizer 或估算库进行预估。不同模型的分词方式可能不同,最终计费请以控制台账单和开发者指南说明为准。
为什么输出被截断?
为什么输出被截断?
常见原因包括
max_tokens 设置过小、模型上下文窗口不足、输入过长或触发安全策略。可以检查响应中的 finish_reason。如何实现对话记忆?
如何实现对话记忆?
API 本身不保存你的业务会话。你需要在应用层保存历史消息,并在下一次请求时传入需要保留的
messages。返回模型不存在怎么办?
返回模型不存在怎么办?
检查
model 是否与控制台展示完全一致,并确认当前 API Key 所属 Token 组有该模型权限。可以切换加速线路吗?
可以切换加速线路吗?
可以。通用线路为
https://api.aiearth.dev/v1,CDN 加速线路为 https://api.aiearth.vip/v1。请按你的网络环境测试后选择。相关文档
聊天补全接口参考
可在导航中的 OpenAI 兼容接口 分组查看
POST /chat/completions 的 OpenAPI 参数参考。模型列表
可在导航中的 OpenAI 兼容接口 分组查看模型列表接口。
文本向量 API
可在导航中的 OpenAI 兼容接口 分组查看文本向量接口。
快速开始
完成 API Key、端点和第一次模型调用。