第一步:获取 API Key
访问 API Key 管理页面 创建密钥(sk- 开头)。所有请求都通过 HTTP 头认证:
Authorization: Bearer YOUR_API_KEY第二步:发起文本对话
平台完全兼容 OpenAI 协议,把 Base URL 换成 https://api.maitoken.com/v1 即可使用现有 SDK:
curl -X POST https://api.maitoken.com/v1/chat/completions \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-5.6-sol", "messages": [{ "role": "user", "content": "你好,介绍一下你自己" }] }'可用模型以 列出模型 返回为准。Anthropic / Gemini 原生协议同样支持,见 Messages API。
生成图像(同步)
图像生成为同步接口,响应直接返回图片,无需轮询(生成期间连接保持,客户端超时建议 ≥ 180 秒):
curl -X POST https://api.maitoken.com/v1/images/generations \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-image-1", "prompt": "赛博朋克城市夜景,雨后霓虹", "size": "1024x1024" }'详见 图像生成。
生成视频(异步)
视频生成为异步接口:提交返回任务 Id,轮询到终态后获取结果。以 Sora 为例:
# 1. 提交curl -X POST https://api.maitoken.com/v1/videos \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "sora-2", "prompt": "海边日落,浪花拍打礁石", "seconds": "8" }' # 2. 轮询(5-10 秒一次,直到 status=completed)curl https://api.maitoken.com/v1/videos/{video_id} \ -H "Authorization: Bearer YOUR_API_KEY" # 3. 下载curl https://api.maitoken.com/v1/videos/{video_id}/content \ -H "Authorization: Bearer YOUR_API_KEY" --output video.mp4不同视频厂商的提交端点与任务体不同(均为厂商原生协议):Sora / Kling / Seedance。
下一步
- 列出模型 — 查看你的 Key 可用的全部模型与协议
- 速率限制 — 限流与重试建议
- Claude Code / Codex 等工具接入