One API
All Models

Faster access More reliable Lower cost

API BASE URL

/v1

View Docs

QUICK START

Start in Three Steps

Sign In

Open your user center to view only your own balance, access, and usage.

Issue a Key

Name the key, set its limits, and use every enabled model.

Switch the URL

Set the API Base URL in your client and keep its native protocol.

快速开始

从注册到发出第一个请求,大约五分钟。

注册并登录

用邮箱或 Google 注册,然后进入控制台。

充值

打开控制台的钱包页,用 PayPal 支付——Visa、Mastercard、Amex 无需 PayPal 账户即可直接刷卡,最低 $1。

创建 API Key

在控制台的 API Keys 页新建密钥,复制并妥善保存。

发送第一个请求

把下面命令里的 YOUR_API_KEY 换成你的密钥。

第一个请求

curl

curl https://api.luckyapi.online/v1/responses \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-sol",
    "input": "Introduce yourself in one sentence"
  }'

提示

返回 JSON 即表示链路全通。模型名以控制台模型页的实际列表为准。

下一步:接入一个编程工具,或直接调用媒体 API。

认证与端点

所有请求发往同一个 Base URL,用 API Key 作为 Bearer 令牌认证。

API 基础地址

Base URL

https://api.luckyapi.online

请求头

Header

Authorization: Bearer YOUR_API_KEY

端点总表

协议 / 能力	端点
OpenAI Responses 协议	POST `/v1/responses`
OpenAI Chat Completions	POST `/v1/chat/completions`
Anthropic Messages 协议	POST `/v1/messages`
模型列表	GET `/v1/models`
图像生成与编辑	POST `/v1/images/generations · /v1/images/edits`
视频生成(异步)	POST `/v1/videos/generations`

各协议请求体与官方格式一致;媒体 API 的完整可运行示例见左侧对应章节。

CC Switch

通过图形界面管理 Provider,是 Codex 和 Claude Code 最简单的接入方式。

1打开 CC Switch,新增一个自定义 Provider。
2选择 Codex 或 Claude,并填写下方对应的 Base URL。
3填写 LuckyAPI Key,然后启用这个 Provider。
4如果目标应用已经运行,请重启应用。

Codex

https://api.luckyapi.online/v1

Claude Code

https://api.luckyapi.online

API Key

YOUR_API_KEY

打开 CC Switch Provider 指南

共享配置

Codex CLI / Desktop

Codex CLI 与 Codex Desktop 在系统用户和 CODEX_HOME 相同时,共用同一份用户级配置。保存后重启 Codex Desktop,或新开一个 Codex CLI 会话。

配置文件 ~/.codex/config.toml

~/.codex/config.toml

model = "gpt-5.6-sol"
model_provider = "luckyapi"

[model_providers.luckyapi]
name = "LuckyAPI"
base_url = "https://api.luckyapi.online/v1"
wire_api = "responses"
requires_openai_auth = false
experimental_bearer_token = "YOUR_API_KEY"

Claude Code

在 Claude Code 用户配置中设置原生接口地址和认证 Token,一次配置即可持续使用。

配置文件 ~/.claude/settings.json

~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.luckyapi.online",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY"
  }
}

提示

保存配置后,请重启客户端。

OpenAI Images

GPT Image

POST/v1/images/generations

POST/v1/images/edits

同时支持文生图和参考图编辑。图片请求通常比文本请求更慢,请为客户端设置更长的超时时间。

文生图(JSON)

bash

curl -sS --max-time 600 \
  https://api.luckyapi.online/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A red apple on a wooden table, square 1:1 composition",
    "n": 1,
    "response_format": "b64_json"
  }' \
  -o image-response.json

参考图编辑(multipart,1–16 张)

bash

curl -sS --max-time 600 \
  https://api.luckyapi.online/v1/images/edits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=gpt-image-2" \
  -F "prompt=Combine the references into one cyberpunk scene, keep the subjects and use a square 1:1 composition" \
  -F "image[]=@./reference-1.png" \
  -F "image[]=@./reference-2.png" \
  -F "image[]=@./reference-3.png" \
  -F "n=1" \
  -F "response_format=b64_json" \
  -o image-edit-response.json

注意

上传 1–16 张参考图时,每个文件都重复使用一个 image[] 字段,并放在同一个 multipart 请求中;不要把多个路径拼进同一个字段。
当前 gpt-image-2 路由需要在提示词中写明期望比例,例如 1:1、16:9 或 9:16。size 和 quality 兼容字段会继续转发,但上游可能将其归一为 auto,因此不能保证精确像素尺寸或质量档位。
n 必须是正整数,用于请求多张结果;最终返回数量由上游决定。每张返回图片都会出现在 data[].b64_json 中并单独计费,因此增大 n 也会增加耗时、响应体积和费用。

xAI Imagine

Grok Image

POST/v1/images/generations

POST/v1/images/edits

使用同一个 LuckyAPI Key 完成 Grok 文生图,或编辑最多 3 张本地参考图。

文生图(JSON)

bash

curl -sS --fail-with-body --max-time 600 \
  https://api.luckyapi.online/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-image-quality",
    "prompt": "A cinematic spacecraft leaving a Martian canyon",
    "aspect_ratio": "16:9",
    "resolution": "2k",
    "n": 1,
    "response_format": "url"
  }' \
  -o grok-image-response.json

查看响应并下载第一张图片

bash

RESPONSE=grok-image-response.json

jq . "$RESPONSE"
URL=$(jq -er '.data[0].url' "$RESPONSE") || exit 1
curl -fL "$URL" -o grok-image.png

参考图编辑(multipart,1–3 张)

bash

curl -sS --fail-with-body --max-time 600 \
  https://api.luckyapi.online/v1/images/edits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=grok-imagine-image-quality" \
  -F "prompt=Combine the subjects into one cinematic cyberpunk scene" \
  -F "image=@./reference-1.png" \
  -F "image=@./reference-2.png" \
  -F "image=@./reference-3.png" \
  -o grok-image-edit-response.json

注意

上传 1–3 个本地文件时,在同一个 multipart 请求里重复 image 字段。LuckyAPI 会把文件转换成 xAI 要求的 JSON 图片对象;未设置 aspect_ratio 时,输出比例跟随第一张输入图。
使用 aspect_ratio 控制画幅,resolution 仅支持 1k 或 2k。n 用于请求多张结果,每张返回图片都会单独计费。
默认响应返回临时的 data[].url,请及时下载。下载图生图结果时,把下载步骤里的 RESPONSE 改成 grok-image-edit-response.json;需要直接携带图片数据时,可将 response_format 设置为 b64_json。

xAI Imagine

Grok Video 1.5

POST/v1/videos/generations

GET /v1/videos/{id} 与 GET /v1/videos/{id}/content

视频生成是异步任务:先提交任务,需要时查询状态,再通过受保护的内容端点自动等待并下载 MP4。

步骤 1:提交文生视频任务

bash

API_KEY="YOUR_API_KEY"
BASE="https://api.luckyapi.online"

ID=$(curl -fsS "$BASE/v1/videos/generations" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video-1.5",
    "prompt": "A cinematic spacecraft leaving a Martian canyon",
    "duration": 10,
    "aspect_ratio": "16:9",
    "resolution": "720p"
  }' \
  | jq -er '.request_id') || exit 1

printf 'Request ID: %s\n' "$ID"

步骤 2:查询任务状态

bash

curl -fsS "$BASE/v1/videos/$ID" \
  -H "Authorization: Bearer $API_KEY" | jq .

步骤 3:自动等待并下载 MP4

bash

curl -fSL --retry 120 --retry-delay 5 --retry-all-errors \
  "$BASE/v1/videos/$ID/content" \
  -H "Authorization: Bearer $API_KEY" \
  -o grok-video.mp4

提示

pending 表示仍在生成;done 表示视频已经完成;failed 或 expired 表示本次任务未完成,应查看完整状态响应中的上游错误。下载命令每 5 秒重试一次,最长约 10 分钟,并且不会把 HTTP 错误正文保存成 MP4。

图生视频(1 张本地首帧图)

bash

base64 < ./reference.png | tr -d '\n' | \
jq -Rs '{
  model: "grok-imagine-video-1.5",
  prompt: "Animate this still image with a slow cinematic camera move",
  image: {url: ("data:image/png;base64," + .)},
  duration: 10,
  resolution: "720p"
}' > grok-video-request.json

curl -sS --fail-with-body \
  https://api.luckyapi.online/v1/videos/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @grok-video-request.json | jq .

image 接受 1 个公开 HTTPS 地址、base64 Data URI 或 file_id,并将其作为视频首帧。拿到 request_id 后,继续复用上方的状态查询与内容下载端点。

多参考图视频(JSON,1–7 张)

bash

curl -sS --fail-with-body \
  https://api.luckyapi.online/v1/videos/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video-1.5",
    "prompt": "Use the person from <IMAGE_0> and the clothing from <IMAGE_1>",
    "reference_images": [
      {"url": "https://example.com/person.png"},
      {"url": "https://example.com/clothing.png"}
    ],
    "duration": 10,
    "aspect_ratio": "16:9",
    "resolution": "720p"
  }' | jq .

注意

reference_images 接受 1–7 个公开地址、base64 Data URI 或 file_id,用于引导视频内容但不会锁定首帧;多参考图模式最高支持 720p。
image 与 reference_images 不能同时使用。时长支持 1–15 秒;画幅支持 1:1、16:9、9:16、4:3、3:4、3:2、2:3;文生视频和图生视频支持 480p、720p、1080p。

Google Flow

Gemini Omni

POST/v1/videos/generations

Gemini Omni 是异步视频接口,支持文生视频、1 张本地首帧图或 1–5 张本地参考图;每次请求返回 1 个 MP4。

步骤 1:提交文生视频任务

bash

API_KEY="YOUR_API_KEY"
BASE="https://api.luckyapi.online"

ID=$(curl -fsS "$BASE/v1/videos/generations" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-omni-flash",
    "prompt": "A cinematic sunrise over the ocean with a slow camera push",
    "duration": 8,
    "aspect_ratio": "16:9",
    "resolution": "720p"
  }' \
  | jq -er '.request_id') || exit 1

printf 'Request ID: %s\n' "$ID"

步骤 2:查询任务状态

bash

curl -fsS "$BASE/v1/videos/$ID" \
  -H "Authorization: Bearer $API_KEY" | jq .

步骤 3:自动等待并下载 MP4

bash

curl -fSL --retry 120 --retry-delay 5 --retry-all-errors \
  "$BASE/v1/videos/$ID/content" \
  -H "Authorization: Bearer $API_KEY" \
  -o gemini-omni.mp4

提示

pending 表示仍在生成;done 表示 MP4 已经完成;failed 表示本次生成未完成,应查看完整状态响应中的上游错误。下载命令每 5 秒重试一次,最长约 10 分钟。

图生视频(1 张本地首帧图)

bash

curl -sS --fail-with-body \
  https://api.luckyapi.online/v1/videos/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=gemini-omni-flash" \
  -F "prompt=Animate this first frame with a slow cinematic camera move" \
  -F "duration=8" \
  -F "aspect_ratio=16:9" \
  -F "resolution=720p" \
  -F "image=@./first-frame.jpg;type=image/jpeg" | jq .

image 只接受 1 张本地 PNG 或 JPEG,并将其固定为视频首帧。拿到 request_id 后,继续复用上方的状态查询与内容下载端点。

多参考图视频(multipart,1–5 张)

bash

curl -sS --fail-with-body \
  https://api.luckyapi.online/v1/videos/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=gemini-omni-flash" \
  -F "prompt=Use the person and wardrobe from the reference images" \
  -F "duration=8" \
  -F "aspect_ratio=9:16" \
  -F "resolution=720p" \
  -F "reference_images=@./person.png;type=image/png" \
  -F "reference_images=@./wardrobe.jpg;type=image/jpeg" | jq .

注意

上传 1–5 张本地 PNG 或 JPEG 时,在同一个 multipart 请求中重复 reference_images 字段;每张图片不得超过 5 MiB 或 2500 万像素。
duration、aspect_ratio 和 resolution 必填。时长仅支持 4、6、8、10 秒;画幅仅支持 16:9、9:16;分辨率仅支持 720p、1080p。每次请求只生成 1 条视频,因此 n 只能是 1;image 与 reference_images 不能同时使用。
720p 与 1080p 均按定价页所示的同一按次价格计费。1080p 会在基础生成后再执行一次二次渲染,因此耗时更长;二次渲染失败时任务会失败,不会静默降级为 720p。

常见问题

请求返回 401 Unauthorized

检查 Authorization: Bearer 请求头,确认密钥完整复制;密钥可随时在 API Keys 页重建。

提示模型不存在或无权限

模型名以控制台模型页的实际列表为准;同时确认你的密钥所在分组有权访问该模型。

充值后没有到账

到账由已验证的 PayPal 支付通知驱动,通常数秒内完成;订单长时间待支付时,可在钱包页查看状态,待支付订单可取消后重试。

图像或视频请求超时

生成类请求比文本慢,把客户端超时调到 600 秒;视频接口是异步任务,先提交再按视频章节轮询状态。

One APIAll Models

Start in Three Steps

Sign In

Issue a Key

Switch the URL

快速开始

第一个请求

认证与端点

API 基础地址

请求头

端点总表

CC Switch

Codex CLI / Desktop

配置文件 ~/.codex/config.toml

Claude Code

配置文件 ~/.claude/settings.json

GPT Image

文生图(JSON)

参考图编辑(multipart,1–16 张)

Grok Image

文生图(JSON)

查看响应并下载第一张图片

参考图编辑(multipart,1–3 张)

Grok Video 1.5

步骤 1:提交文生视频任务

步骤 2:查询任务状态

步骤 3:自动等待并下载 MP4

图生视频(1 张本地首帧图)

多参考图视频(JSON,1–7 张)

Gemini Omni

步骤 1:提交文生视频任务

步骤 2:查询任务状态

步骤 3:自动等待并下载 MP4

图生视频(1 张本地首帧图)

多参考图视频(multipart,1–5 张)

常见问题

Project Sponsorship

Channel Revenue Share

Information we process

Account identity

How information is used

Sharing and retention

Your choices

Accounts and credentials

Acceptable use

Usage and billing

Availability

Changes

API Key

Top Up

Top-up Orders

Usage Trends & Cost Distribution

Token & Request Trend

Cost Distribution

Daily Usage

Request Details

One API
All Models