常見問題
尋找有關 ApiSmart API 金鑰、模型、文字、圖片與影片生成、帳單、使用量以及 API 錯誤的常見問題解答。
尋找關於使用 ApiSmart API 的常見問題快速解答。
如需詳細的整合範例,請參閱 快速開始 或對應的 API 指南。
🔑 API 存取
ApiSmart API Base URL 是什麼?
請使用:
https://gw.apismart.ai/v1所有已驗證的請求都會在 Authorization 標頭中使用 API Key:
Authorization: Bearer <your-api-key>我要在哪裡使用我的 API Key?
請在每個已驗證的 API 請求的 Authorization 標頭中加入您的 API Key。
請勿在前端程式碼、公開儲存庫、截圖或應用程式日誌中暴露 API Key。
請參閱 建立與管理 API Key 和 保護您的 API Key.
為什麼我會收到 401 invalid_api_key?
這表示無法驗證您的 API Key。
請檢查金鑰是否正確,且您的標頭使用:
Authorization: Bearer <your-api-key>如需更多說明,請參閱 API Key 與驗證問題.
🧩 模型
我要如何找到可用的模型 ID?
請呼叫:
請在您的 API 請求中使用返回的 data[].id 值。
為什麼模型 ID 必須完全一致?
ApiSmart 會精確比對模型 ID。句點、連字號與版本號都不能更改。
例如:
模型 ID 拼寫錯誤可能會導致非預期的 503,因此請逐字元確認模型 ID。
為什麼我會得到 403 model_not_allowed 即使模型出現在 /v1/models?
GET /v1/models 回傳系統模型清單,但並非每個模型都一定會對每個 API Key 啟用。
一個 403 model_not_allowed 回應表示目前所選模型無法供您的帳戶或 API Key 使用。
請參閱 模型與模型 ID 詳情。
💬 文字生成
文字模型應該使用哪個端點?
請使用:
ApiSmart 文字模型使用與 OpenAI 相容的 Chat Completions 請求格式。
Chat Completions 支援串流嗎?
是。
加入:
到請求本文中即可啟用串流輸出。
請參閱 Chat Completions API 和 回應模式.
🖼️ 圖片生成
圖片生成需要多久?
預設情況下,圖片生成是同步的。
單張圖片通常需要約 20–40 秒。高解析度、多參考或連續圖片生成可能需要更久。
請將您的用戶端逾時至少設定為 90 秒.
我可以使用參考圖片嗎?
是。
圖片生成 API 支援:
文字生成圖片
單張參考圖片
多張參考圖片
連續圖片生成
串流輸出
最多支援 14 張參考圖片 ,但仍受文件中所述的圖片限制約束。
請參閱 圖片生成 API 完整需求。
我可以上傳本地圖片嗎?
是。
請使用:
並使用 multipart form data。
每張上傳圖片不得超過 10 MB,且最多支援 14 張參考圖片。
我可以在哪裡找到先前生成的圖片?
請使用:
以擷取最近的圖片生成歷史。
目前歷史 API 只允許查詢最近的 7 天.
請參閱 生成媒體歷史.
🎬 影片生成
影片生成是同步的嗎?
否。
影片生成使用非同步任務工作流程:
您的應用程式應先建立任務,然後輪詢其狀態直到生成完成。
我會收到哪些影片任務狀態?
可能的狀態包括:
queued
在佇列中等待
running
生成進行中
succeeded
生成完成
failed
生成失敗
cancelled
任務已取消
expired
任務已過期
當任務處於 queued 或 running.
為什麼我應該明確指定影片解析度和時長?
影片計費與支援設定會因模型而異。
例如,HappyHorse 的預設為 1080p 計費 當未指定解析度時,以及 5 秒 當未指定時長時。Seedance 使用不同的解析度規則。
為避免非預期費用或不支援的設定,請在建議時明確指定這些參數。
我可以在哪裡找到先前生成的影片?
請使用:
該端點會回傳最近完成且成功的影片生成。
目前只能查詢最近的 7 天 ,且不包含佇列中、執行中或失敗的任務。
若要查看進行中的任務,請改用 GET /v1/video/tasks/{id} 。
💰 計費與用量
API 請求如何計費?
計費取決於所選模型與工作負載。
文字、圖片與影片模型可能使用不同的計費方式。圖片生成可能依交付的圖片結果計費,而影片價格則可能取決於模型、時長、解析度或生成的 token。
如需目前的價格與計費規則,請參閱 模型定價與計費.
什麼是 402 insufficient_quota 的意思?
您的帳戶沒有足夠的可用餘額來完成此請求。
重試前請檢查您的錢包餘額與最近用量。
請參閱 餘額與用量限制問題.
什麼是 429 rate_limit_error 的意思?
已達到服務速率限制。
請降低請求頻率,並使用受控退避在稍後重試。這不表示您的錢包餘額不足。
⚠️ 錯誤與疑難排解
如果我收到 502, 503,或 504?
這些錯誤可能表示暫時性的供應商、閘道或網路層問題。
請使用受控重試與指數退避。如果回應包含 Retry-After,請在適用時遵循。
針對意外的 503,也請先確認模型 ID。
請參閱 逾時與連線問題.
我可以在哪裡查看失敗的請求與費用?
使用 使用記錄與費用 來檢視請求層級資訊,例如模型、狀態、消耗、費用與 Request ID。
當您就 API 請求聯絡 ApiSmart 支援時,請提供相關的 Request ID (若可用)。
切勿提供您的完整 API Key。
➡️ 需要更多幫助?
繼續閱讀:
最後更新於
這有幫助嗎?