API 概述

1XM.AI API 兼容 OpenAI API 格式，支持 Claude、GPT、Gemini 等多种模型。

🌐 接入端点

用途	Base URL
Claude Code 专用	https://1xm.ai
OpenAI 兼容接口（Codex、SDK、Cursor 等）	https://api.1xm.ai/v1
Gemini 接口	https://1xm.ai

📡 主要端点

端点	方法	说明
/v1/chat/completions	POST	聊天补全（主要接口）
/v1/models	GET	列出可用模型
/v1/embeddings	POST	向量嵌入
/v1/images/generations	POST	同步图片生成
/v1/images/edits	POST	同步图片编辑
/v1/images/tasks	POST	异步创建图片任务，适合 4K、编辑、多参考图等长耗时场景
/v1/images/tasks/{task_id}	GET	查询异步图片任务状态和结果
/v1/videos	POST	异步创建视频生成任务
/v1/videos/{task_id}	GET	查询视频任务状态和结果
/v1/videos/{task_id}/content	GET	下载或代理读取视频内容

🔑 认证

所有请求需要在 Header 中携带 API Key：

Authorization: Bearer sk-xxxxx

📝 请求示例

curl -X POST https://api.1xm.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-你的Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [{"role": "user", "content": "用 Python 写一个快速排序"}]
  }'

响应：

{
  "id": "chatcmpl-xxx",
  "object": "chat.completion",
  "model": "claude-sonnet-4-6",
  "choices": [{
    "index": 0,
    "message": {
      "role": "assistant",
      "content": "def quick_sort(arr): ..."
    },
    "finish_reason": "stop"
  }],
  "usage": {
    "prompt_tokens": 20,
    "completion_tokens": 150,
    "total_tokens": 170
  }
}

🔧 常用参数

参数	类型	必填	说明
model	string	✅	模型 ID，参考支持的模型
messages	array	✅	消息数组
temperature	float	❌	采样温度 0-2
max_tokens	int	❌	最大生成 tokens
stream	boolean	❌	是否流式输出

📦 SDK

# Python
pip install openai

# Node.js
npm install openai

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的Key",
    base_url="https://1xm.ai/v1"
)

从其他 OpenAI 兼容服务迁移只需修改 api_key 和 base_url 两个参数。

📖 更多文档

• 认证方式
• 调用示例
• GPT-Image-2 图片 API
• Nano Banana 图片 API
• 视频生成 API
• 错误码
• 限流说明