For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to page URLs.
跳至內容

常見問題

尋找有關 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 使用不同的解析度規則。

為避免非預期費用或不支援的設定,請在建議時明確指定這些參數。

請參閱 影片生成 API 和 模型定價與計費.

我可以在哪裡找到先前生成的影片?

請使用:

該端點會回傳最近完成且成功的影片生成。

目前只能查詢最近的 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。

➡️ 需要更多幫助?

繼續閱讀:

最後更新於

這有幫助嗎?