Google AI Studio API 中繼

對應 Google Generative Language API 規格 (Gemini / Veo / Lyria)。認證用 x-goog-api-key: YOUR_API_KEY 或 Authorization: Bearer YOUR_API_KEY 標頭（金鑰不可放在網址查詢參數；?key= query 已停用——Google 官方 SDK 預設即用 header）。

POST https://www.myai168.com/ardswc/api/google/v1beta/models/{model}:generateContent

Gemini 文字對話 (non-streaming)。

curl "https://www.myai168.com/ardswc/api/google/v1beta/models/gemini-3.1-pro-preview:generateContent" \
  -H "x-goog-api-key: YOUR_DEV_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contents":[{"parts":[{"text":"Hello"}]}]}'

import requests

r = requests.post(
    "https://www.myai168.com/ardswc/api/google/v1beta/models/gemini-3.1-pro-preview:generateContent",
    headers={"x-goog-api-key": "YOUR_DEV_KEY"},
    json={"contents": [{"parts": [{"text": "Hello"}]}]},
)
print(r.json())

POST https://www.myai168.com/ardswc/api/google/v1beta/models/{model}:streamGenerateContent

Gemini 文字對話 (SSE streaming)。本中繼一律回 SSE（伺服器端已對上游強制 alt=sse），與直連 Google 官方 API 不同、網址不需自行加 ?alt=sse（帶了也會被忽略）。

curl "https://www.myai168.com/ardswc/api/google/v1beta/models/gemini-3.1-pro-preview:streamGenerateContent" \
  -H "x-goog-api-key: YOUR_DEV_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contents":[{"parts":[{"text":"Hello"}]}]}'

import requests

r = requests.post(
    "https://www.myai168.com/ardswc/api/google/v1beta/models/gemini-3.1-pro-preview:streamGenerateContent",
    headers={"x-goog-api-key": "YOUR_DEV_KEY"},
    json={"contents": [{"parts": [{"text": "Hello"}]}]},
    stream=True,
)
for line in r.iter_lines():
    if line:
        print(line.decode("utf-8"))

POST https://www.myai168.com/ardswc/api/google/v1beta/models/gemini-3-pro-image-preview:generateContent

Nano Banana Pro 文字生圖（Gemini 多模態，回 inline_data base64 image）。

curl "https://www.myai168.com/ardswc/api/google/v1beta/models/gemini-3-pro-image-preview:generateContent" \
  -H "x-goog-api-key: YOUR_DEV_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contents":[{"parts":[{"text":"A cat"}]}],"generationConfig":{"responseModalities":["TEXT","IMAGE"]}}'

import requests

r = requests.post(
    "https://www.myai168.com/ardswc/api/google/v1beta/models/gemini-3-pro-image-preview:generateContent",
    headers={"x-goog-api-key": "YOUR_DEV_KEY"},
    json={"contents": [{"parts": [{"text": "A cat"}]}], "generationConfig": {"responseModalities": ["TEXT", "IMAGE"]}},
)
print(r.json())

POST https://www.myai168.com/ardswc/api/google/v1beta/models/veo-{ver}:predictLongRunning

Veo 影片生成 (LRO; 第一次回 operation name，後續 poll 取結果)。

curl "https://www.myai168.com/ardswc/api/google/v1beta/models/veo-3.1-generate-preview:predictLongRunning" \
  -H "x-goog-api-key: YOUR_DEV_KEY" \
  -H "Content-Type: application/json" \
  -d '{"instances":[{"prompt":"A cat dancing"}],"parameters":{"durationSeconds":8}}'

import requests

r = requests.post(
    "https://www.myai168.com/ardswc/api/google/v1beta/models/veo-3.1-generate-preview:predictLongRunning",
    headers={"x-goog-api-key": "YOUR_DEV_KEY"},
    json={"instances": [{"prompt": "A cat dancing"}], "parameters": {"durationSeconds": 8}},
)
print(r.json())

POST https://www.myai168.com/ardswc/api/google/v1beta/models/lyria-{ver}:predict

Lyria 音樂生成 (回 base64 audio)。注意：Google 官方已將 Gemini API 的音樂生成改版為 Lyria 3（lyria-3-clip-preview／lyria-3-pro-preview，走新的 Interactions API），官方文件已不再列 lyria-002 的 :predict 介面——本端點維持舊介面轉發，若上游已停止支援會回上游錯誤（不扣點），可用性請以 Google 官方公告為準。

curl "https://www.myai168.com/ardswc/api/google/v1beta/models/lyria-002:predict" \
  -H "x-goog-api-key: YOUR_DEV_KEY" \
  -H "Content-Type: application/json" \
  -d '{"instances":[{"prompt":"Upbeat jazz"}],"parameters":{"sampleCount":1}}'

import requests

r = requests.post(
    "https://www.myai168.com/ardswc/api/google/v1beta/models/lyria-002:predict",
    headers={"x-goog-api-key": "YOUR_DEV_KEY"},
    json={"instances": [{"prompt": "Upbeat jazz"}], "parameters": {"sampleCount": 1}},
)
print(r.json())

GET https://www.myai168.com/ardswc/api/google/v1beta/operations/{name}

查詢 LRO 操作狀態 (Veo poll 用，查詢類不扣點)。

curl "https://www.myai168.com/ardswc/api/google/v1beta/operations/OP_NAME" \
  -H "x-goog-api-key: YOUR_DEV_KEY"

import requests

r = requests.get(
    "https://www.myai168.com/ardswc/api/google/v1beta/operations/OP_NAME",
    headers={"x-goog-api-key": "YOUR_DEV_KEY"},
)
print(r.json())

請求參數（generateContent／streamGenerateContent）

請求本體為 JSON，與 Google 官方規格相同。認證帶 x-goog-api-key 或 Authorization: Bearer 標頭。

模型代號放在網址路徑（models/{model}:generateContent）；不在計價表內的模型回 "No pricing info! Please use other models!"。Veo 用 instances＋parameters（durationSeconds／numberOfVideos／resolution），Lyria 用 instances＋parameters.sampleCount（見上一題範例）。

回應格式

非串流：官方 JSON——文字在 candidates[0].content.parts[]、用量在 usageMetadata；回應標頭另帶 X-Cost-Points（本次扣點）與 X-Credits-Remaining（扣後餘額）。串流（:streamGenerateContent）為 SSE 逐段，結束後以 SSE 註解行 : cost=N／: credits-remaining=M 附上本次扣點與餘額；也可隨時查 GET https://www.myai168.com/ardswc/api/user/get_credits。

錯誤碼

任何錯誤（含供應商未回用量資訊）一律不扣點；查詢 LRO 狀態（operations）免費。