接口文档 - 极客AI开放平台

基础

基本信息

本平台提供标准 OpenAI 兼容格式的 API 接口，Base URL 如下：

BASE https://ai.18years.shop/v1

项目	内容
协议	HTTPS
数据格式	JSON
编码	UTF-8
请求方式	POST / GET

认证

认证方式

所有 API 请求需在 HTTP Header 中携带你在本平台创建的 API Key。

HTTP Header

Authorization: Bearer YOUR_API_KEY

在令牌管理页面创建你的专属 API Key。

CHAT

文本系列

POST /v1/chat/completions

创建对话请求，支持流式和非流式返回。兼容 OpenAI 标准格式。

请求参数

参数	类型	必填	说明
`model`	string	是	模型ID
`messages`	array	是	消息数组
`temperature`	float	否	采样温度，默认 0.7
`max_tokens`	int	否	最大生成 tokens
`stream`	boolean	否	是否流式返回

cURL

curl https://ai.18years.shop/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-oss-20b",
    "messages": [{"role": "user", "content": "你好"}],
    "stream": false
  }'

可用模型

openai/gpt-oss-20b gpt-oss-2b

输入 ¥0.000100/1K 输出 ¥0.000700/1K 128 ctx

deepseek-ai/DeepSeek-V4-Flash deepseek

输入 ¥0.002000/1K 输出 ¥0.003000/1K 1,000,000 ctx

Pro/moonshotai/Kimi-K2.6 Kimi

输入 ¥0.008500/1K 输出 ¥0.035000/1K 256 ctx

Pro/moonshotai/Kimi-K2.5 Kimi

输入 ¥0.006000/1K 输出 ¥0.023000/1K 256 ctx

IMAGE

图像系列

POST /v1/images/generations

根据文本描述生成图像。

参数	类型	必填	说明
`model`	string	是	图像模型ID
`prompt`	string	是	图像描述
`n`	int	否	生成数量
`size`	string	否	尺寸

可用模型

Tongyi-MAI/Z-Image-Turbo 生图6B参数

输入 ¥0.300000/1K 输出 ¥0.300000/1K - ctx

Qwen/Qwen-Image-Edit-2509 文生图，图生图20B

输入 ¥0.800000/1K 输出 ¥0.800000/1K - ctx

Kwai-Kolors/Kolors kolors

输入 ¥0.100000/1K 输出 ¥0.100000/1K - ctx

AUDIO

语音系列

POST /v1/audio/transcriptions

语音转文字接口。

参数	类型	必填	说明
`model`	string	是	音频模型ID
`file`	file	是	音频文件
`language`	string	否	语言代码

可用模型

TeleAI/TeleSpeechASR TeleAI/TeleSpeechASR

输入 ¥0.050000/1K 输出 ¥0.050000/1K - ctx

PPT

ppt

可用模型

ppt PPT生成

输入 ¥1.000000/1K 输出 ¥1.000000/1K - ctx

PPT

PPT 系列

POST /v1/ppt/generate

一键生成 PPT，根据主题或文档内容自动生成完整演示文稿。

固定价格：每次调用 ¥1.00

请求参数

参数	类型	必填	说明
`subject`	string	条件	PPT 主题，与 dataUrl 至少填一个
`dataUrl`	string	条件	文档数据 URL，解析内容生成 PPT
`stream`	boolean	否	是否流式返回，默认 true
`templateId`	string	否	模板 ID，不传使用随机模板
`pptxProperty`	boolean	否	是否返回 PPT 属性，默认 false
`length`	string	否	篇幅长度：short/medium/long，默认 medium
`lang`	string	否	语言，默认 zh
`prompt`	string	否	用户自定义需求

请求示例

cURL

curl https://ai.18years.shop/v1/ppt/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "subject": "人工智能发展趋势",
    "stream": true,
    "length": "medium",
    "lang": "zh",
    "prompt": "面向企业高管，突出商业价值"
  }'

响应示例

JSON

{
  "code": 0,
  "message": "success",
  "data": {
    "pptInfo": {
      "id": "ppt_xxx",
      "name": "人工智能发展趋势",
      "subject": "人工智能发展趋势",
      "coverUrl": "https://...",
      "fileUrl": "https://...",
      "templateId": "template_xxx",
      "updateTime": "2026-05-06 12:00:00",
      "createTime": "2026-05-06 12:00:00"
    }
  },
  "usage": {
    "cost_cny": 1.00,
    "balance_remaining": 99.00,
    "call_type": "ppt_generation"
  }
}

GET

模型列表

GET /v1/models

获取当前平台所有可用的模型列表。

cURL

curl https://ai.18years.shop/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

计费

计费说明

本平台采用按量计费模式。

计费公式

总费用 = (输入 tokens ÷ 1000 × 输入单价) + (输出 tokens ÷ 1000 × 输出单价)

计费规则

按实际消耗的 tokens 数量计费，精确到小数点后6位
输入和输出分别计费，价格以模型配置为准
余额不足时接口返回 402 错误
流式和非流式请求计费方式一致
计费信息会在响应的 usage.cost_cny 字段中返回

价格参考

模型	输入价格	输出价格	上下文
`openai/gpt-oss-20b`	¥0.000100/1K	¥0.000700/1K	128
`deepseek-ai/DeepSeek-V4-Flash`	¥0.002000/1K	¥0.003000/1K	1,000,000
`Pro/moonshotai/Kimi-K2.6`	¥0.008500/1K	¥0.035000/1K	256
`Pro/moonshotai/Kimi-K2.5`	¥0.006000/1K	¥0.023000/1K	256
`Tongyi-MAI/Z-Image-Turbo`	¥0.300000/1K	¥0.300000/1K	-
`Qwen/Qwen-Image-Edit-2509`	¥0.800000/1K	¥0.800000/1K	-

完整模型列表请访问模型广场

错误

错误码

状态码	含义	说明
200	成功	请求处理成功
400	参数错误	请求参数缺失或格式不正确
401	认证失败	API Key 无效或已过期
402	余额不足	账户余额不足以完成请求
403	禁止访问	账号被禁用或无权限
429	请求过频	超出速率限制
500	服务器错误	服务器内部错误
502	上游错误	上游服务连接失败