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 並核對用量記錄。

查看用量