Created by ViNano AI | ViNano AI
ViNano AI文思逸言
進階版專享 API

ViNano AI API

強大的 AI 圖片生成 REST API，幾行程式碼即可整合到您的應用程式中

API 使用要求

  • 需要訂閱進階版（Advanced Plan）
  • 年付費使用者：200 次/分鐘速率限制
  • 月付費使用者：20 次/分鐘速率限制
✉️

需要更進階的 API 功能？

如需更高的速率限制、企業級支援或客製化功能，請發送郵件至：

[email protected]

Skills 整合指南

探索API整合指南、程式碼範例和使用ViNano AI API的最佳實踐

在GitHub上查看

值得期待

為需要大規模圖像處理的開發者而生

⚡

閃電般快速

透過我們優化的 API 基礎設施，在毫秒內處理圖像

🔧

簡單整合

RESTful API，提供完整文件與多語言 SDK

💰

彈性計價

按需付費，透明且對開發者友好的價格

API 呼叫說明

了解如何使用 ViNano AI API 進行圖片生成

快速開始

幾行程式碼即可整合 AI 圖片生成功能

API 端點
POST https://vinano.ai/api/v2/images/generate
curl -X POST https://vinano.ai/api/v2/images/generate \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -F "prompt=a beautiful sunset over the ocean" \
  -F "model=gemini-2.5-flash-image-preview" \
  -F "aspectRatio=16:9" \
  -F "googleSearch=false" \
  -F "mode=txt2img"

請求參數

參數名類型必填為開發者打造的強大圖像編輯 API。用自然語言在毫秒內轉換圖像。
promptstringNo*生成圖片的提示詞（最多2000字元）
imageFile / File[]No*上傳的圖片檔案（支援多個）
imageUrlstring / string[]No*Existing image URL(s) (supports multiple URLs)
modelstringNoAI 模型，支援 gemini-2.5-flash-image-preview, sora_image
aspectRatiostringNo寬高比，如 1:1, 16:9, 9:16
modestringNo可選的生成模式，例如 photo_restoration（老照片修復）、figure、meme 等 查看所有模式
hdProbooleanNo是否使用高清模式（消耗30積分，普通模式10積分）
img_sizestringNo圖片尺寸: 1k, 2k, 4k（僅 gemini-3-pro-image-preview 模型支援，積分消耗: 1k=30, 2k=50, 4k=80）
googleSearchbooleanNo啟用 Google 搜尋增強（僅 gemini-3.1-pro-image-preview 模型支援，預設 false）

* prompt 或 image 至少需要提供一個

支援的模型

  • gemini-2.5-flash-image-preview- Nano Banana（預設模型）
  • gemini-3.1-pro-image-preview- Nano Banana 2（支援擴展寬高比 4:1, 1:4, 8:1, 1:8）
  • gemini-3-pro-image-preview- Nano Banana Pro
  • sora_image- GPT-Image 2
  • Seedance-5.0- Seedance 5.0（僅 2K/3K，支援文生圖 / 圖生圖，支援聯網生成）
  • Z-Image- ViNano Basic（Z-Image，僅文生圖）
查看完整定價 →

回應格式

成功回應 (200)

{
  "status": 200,
  "images": ["https://example.com/generated-image.jpg"],
  "imageDetails": [{
    "width": 1024,
    "height": 1024,
    "filesize": 524288
  }],
  "uuid": "550e8400-e29b-41d4-a716-446655440000",
  "prompt": "a beautiful sunset",
  "model": "gemini-2.5-flash-image-preview",
  "credits": {
    "cost": 10
  }
}

⚡ 非同步圖片生成 API

提交任務取得 task_id，然後輪詢狀態接口直到生成完成。
第一步 — 提交非同步任務
POST https://vinano.ai/api/v1/images/async
第二步 — 輪詢任務狀態
GET https://vinano.ai/api/v1/images/task-status?task_id={task_id}
# Step 1: Submit async task (same parameters as sync API)
curl -X POST "https://vinano.ai/api/v1/images/async" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -F "prompt=a beautiful sunset" \
  -F "model=gemini-2.5-flash-image-preview"

# Response (202):
# {
#   "status": 202,
#   "task_id": "550e8400-e29b-41d4-a716-446655440000",
#   "message": "Task submitted. Use GET /api/v1/images/task-status?task_id={task_id} to poll for results.",
#   "model": "gemini-2.5-flash-image-preview",
#   "credits": { "cost": 10 }
# }

# Step 2: Poll task status (repeat every 3-5s until status=200)
curl -X GET "https://vinano.ai/api/v1/images/task-status?task_id=550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer YOUR_TOKEN"

# Response when completed:
# {
#   "status": 200,
#   "images": ["https://example.com/generated-image.jpg"],
#   "imageDetails": [{
#     "width": 1024,
#     "height": 1024,
#     "filesize": 524288
#   }],
#   "uuid": "550e8400-e29b-41d4-a716-446655440000",
#   "prompt": "a beautiful sunset",
#   "model": "gemini-2.5-flash-image-preview",
#   "credits": {
#     "cost": 10
#   }
# }

錯誤碼說明

狀態碼為開發者打造的強大圖像編輯 API。用自然語言在毫秒內轉換圖像。
400缺少必要參數或參數驗證失敗
401API Token 無效、缺失或格式錯誤
403帳戶被停用、未訂閱進階版或無權限使用 API
413檔案大小超過限制（100MB）
429請求頻率超限（超過每分鐘限制）
495積分不足
500伺服器內部錯誤或圖片生成失敗

最佳實踐

妥善保管 API Token

不要將 API Token 分享給他人或公開在程式碼儲存庫中

實作錯誤處理

處理所有可能的錯誤碼，特別是 429（速率限制）和 495（積分不足）

監控 Rate Limit 標頭

檢查回應標頭中的 X-RateLimit-Remaining 了解剩餘配額

實作重試機制

對於 429 錯誤，根據 Retry-After 標頭實作指數退避重試

最佳化提示詞

清晰、具體的提示詞能獲得更好的生成結果

壓縮圖片

上傳前壓縮圖片可以提高傳輸速度並節省頻寬

API 速率限制

API 呼叫受到速率限制保護，限制因訂閱方案而異：

年
年付費進階版
200 次/分鐘
月
月付費進階版
20 次/分鐘

💡回應標頭中會包含 X-RateLimit-Limit、X-RateLimit-Remaining 和 X-RateLimit-Reset 資訊

HomeAI ImageAI VideoAI ToolsMe