API 快速开始与接入指南

一把 API 密钥接入文本、图像和视频。以下示例使用本站的 API 地址。

创建 API 密钥查看模型与价格

认证与模型选择

在控制台创建并保存密钥，通过 Authorization: Bearer 请求头传入。请在服务端保存和使用密钥。

将 MODEL_ID 替换为已上架的模型 ID。支持的协议、时长、分辨率和价格以该模型的说明为准。

OpenAI SDK

base_url = "https://www.lvzhouai.cc/v1"

文本

POST /v1/chat/completions

bash

curl 'https://www.lvzhouai.cc/v1/chat/completions' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gpt-6-luna",
  "messages": [
    {
      "role": "user",
      "content": "Hello"
    }
  ],
  "max_tokens": 64
}'

图像

POST /v1/images/tasks

bash

curl 'https://www.lvzhouai.cc/v1/images/tasks' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: YOUR_UNIQUE_REQUEST_ID" \
  -d '{
  "model": "gpt-image-2",
  "prompt": "A blue ceramic cup on a wooden table",
  "resolution": "1K"
}'

视频

POST /v1/videos/tasks

bash

curl 'https://www.lvzhouai.cc/v1/videos/tasks' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: YOUR_UNIQUE_REQUEST_ID" \
  -d '{
  "model": "grok-imagine-video-1.5",
  "prompt": "A slow camera movement through a garden",
  "resolution": "480p",
  "duration": 8
}'

Python 与 Node.js 快速接入

在服务端环境变量中设置 API_STATION_KEY。以下示例使用与 curl 相同的文本接口。

Python 3

import json, os
from urllib.request import Request, urlopen

request = Request(
    "https://www.lvzhouai.cc/v1/chat/completions",
    data=json.dumps({"model": "gpt-6-luna", "messages": [{"role": "user", "content": "Hello"}], "max_tokens": 64}).encode(),
    headers={"Authorization": "Bearer " + os.environ["API_STATION_KEY"], "Content-Type": "application/json"},
)
with urlopen(request, timeout=60) as response:
    print(json.load(response)["choices"][0]["message"]["content"])

Node.js 20+

const response = await fetch("https://www.lvzhouai.cc/v1/chat/completions", {
  method: "POST",
  headers: {
    Authorization: "Bearer " + process.env.API_STATION_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "gpt-6-luna",
    messages: [{ role: "user", content: "Hello" }],
    max_tokens: 64,
  }),
});
const result = await response.json();
if (!response.ok) throw new Error(result.error?.message || "Request failed");
console.log(result.choices[0].message.content);

模型、规格与计费单位

文本价格按每百万输入或输出 token 展示；图像按张计费，视频按生成秒数计费。单价取决于模型和规格，提交前请查看最新模型价格。

示例使用已上架的规格：gpt-image-2 为 1K，grok-imagine-video-1.5 为 480p、8 秒。其他尺寸、时长、工具调用或媒体输入需以模型说明为准。

使用 GET /v1/models 查看当前密钥可用的模型。公开模型页提供规格与价格；密钥权限可能限制实际可用列表。

bash

curl 'https://www.lvzhouai.cc/v1/models' \
  -H "Authorization: Bearer YOUR_API_KEY"

媒体任务创建后返回 HTTP 201，包含 id、state 和 billing_state。使用同一 API 密钥轮询 GET /v1/tasks/{id}；succeeded 表示生成成功，settled 表示计费已结算，两者需分别检查。提交结果不确定时，保留原 Idempotency-Key 和输入。

任务状态与结果

每次图片或视频操作使用唯一的 16–128 位 Idempotency-Key。提交结果不明确时，使用相同的键和相同输入重试。

保存创建任务返回的 id，使用同一 API 密钥查询状态。state 为 succeeded 后读取 results[].url，并单独检查 billing_state 扣费状态。

GET /v1/tasks/{id}

bash

curl 'https://www.lvzhouai.cc/v1/tasks/TASK_ID' \
  -H "Authorization: Bearer YOUR_API_KEY"

读取 results[].url，并在提供时检查 results[].expires_at。结果链接是临时的，请及时保存所需文件。查询同一任务可以刷新本站访问链接，不会再次生成；上游结果仍可能过期。

请求异常处理

401 / 403: 检查密钥是否有效，以及是否有对应的模型权限。
400: 检查模型 ID 和支持的输入规格。
402: 当前可用余额不足以提交这次请求。
409: 重试时使用原 Idempotency-Key 和完全相同的输入；执行新操作时使用新的幂等键。
429: 按 Retry-After 指定的间隔等待后再重试。
503: 服务可能已暂停或尚未配置，请联系管理员确认。

反馈问题时保留响应头中的 X-Oneapi-Request-Id。请勿附上 API 密钥、密码或验证码。

文本流开始后请勿自动重试。连接中断时，保留请求 ID 并核对用量记录。

查看用量