快速開始
取得 API Key，並透過最小範例呼叫文字、圖片和影片模型。
取得 API Key，並透過最小範例完成文字對話、圖片生成和影片生成呼叫。
第 2 步：取得 API Key
- 前往 API Keys。
- 按一下建立 API 金鑰。
- 複製並安全儲存你的 API Key。
安全儲存 API Key
請勿在瀏覽器前端、公開程式碼儲存庫、螢幕截圖或記錄中儲存完整的 API Key。若懷疑已洩漏，請立即撤銷。
第 3 步：確認可用額度
API 呼叫會消耗帳戶額度。傳送請求前，請在餘額與儲值頁面確認帳戶有可用額度；儲值方式和入帳結果以控制台顯示為準。
第 4 步：完成第一次 API 呼叫
以下範例使用目前站點的 API 位址和範例模型。實際呼叫前，請從模型廣場確認目前的 API Key 可以使用對應模型。
與 LLM 對話
Chat Completions 相容介面可以透過 OpenAI SDK 或 HTTP 請求呼叫。
from openai import OpenAI
client = OpenAI(
api_key="your-api-key",
base_url="https://api.agtcloud.cn/v1",
)
response = client.chat.completions.create(
model="deepseek-v4-flash",
messages=[
{"role": "user", "content": "你好！你能做什麼？"}
],
)
print(response.choices[0].message.content)回應文字位於 choices[0].message.content。更多參數請參閱 Chat Completions。
生成圖片
curl 'https://api.agtcloud.cn/v1/images/generations' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer your-api-key' \
--data '{
"model": "qwen-image",
"prompt": "一座漂浮在雲海上的未來城市"
}'生成影片
curl 'https://api.agtcloud.cn/v1/video/generations' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer your-api-key' \
--data '{
"model": "doubao-seedance-2-5-260628",
"prompt": "一艘太空船穿越藍色星雲"
}'建立成功後，請儲存回應中的 task_id，再查詢任務狀態和結果：
curl 'https://api.agtcloud.cn/v1/video/generations/your-task-id' \
-H 'Authorization: Bearer your-api-key'保護正式環境中的 API Key
your-api-key 僅用來標示替換位置。正式專案應透過伺服器端環境變數或金鑰管理服務讀取 API Key，請勿將真實金鑰提交至程式碼儲存庫或傳送至瀏覽器前端。
如需在瀏覽器中驗證請求，可以開啟線上偵錯。
第 5 步：探索模型
前往模型廣場尋找適合任務的模型。呼叫前，請確認模型支援的協議、參數和目前帳戶權限。