Created by ViNano AI | ViNano AI
ViNano AI
Advancedプラン専用API

ViNano AI API

強力なAI画像生成REST API、数行のコードでアプリに統合

API使用要件

  • Advancedプランへの登録が必要
  • 年間プランユーザー: 200リクエスト/分のレート制限
  • 月間プランユーザー: 20リクエスト/分のレート制限
✉️

より高度なAPI機能が必要ですか？

より高いレート制限、エンタープライズサポート、またはカスタム機能が必要な場合は、メールでご連絡ください:

[email protected]

Skills 連携ガイド

API連携ガイド、コードサンプル、ViNano AI APIのベストプラクティスを探索

GitHubで見る

期待できること

大規模な画像処理が必要な開発者のために構築

⚡

超高速

最適化されたAPIインフラでミリ秒単位に画像を処理

🔧

シンプルな統合

充実したドキュメントと多言語SDKを備えたRESTful API

💰

柔軟な料金

使った分だけ支払う、透明で開発者に優しい料金体系

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 など すべてのモードを見る
hdProbooleanNoHDモードを使用するかどうか（30クレジット消費、通常モード10クレジット）
img_sizestringNo画像サイズ: 1k, 2k, 4k（gemini-3-pro-image-previewモデルのみ、クレジット: 1k=30, 2k=50, 4k=80）
googleSearchbooleanNoGoogle検索拡張を有効にする（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 を取得し、生成完了までステータスエンドポイントをポーリングします。
ステップ1 — 非同期タスクを送信
POST https://vinano.ai/api/v1/images/async
ステップ2 — タスク状態をポーリング
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トークンが無効、欠落、または形式が正しくありません
403アカウントが無効化されているか、Advancedプランに登録していないか、API権限がありません
413ファイルサイズが制限を超えています（100MB）
429レート制限を超えました（分あたりの制限を超過）
495クレジット不足
500サーバー内部エラーまたは画像生成に失敗しました

ベストプラクティス

APIトークンを安全に保管

APIトークンを他の人と共有したり、コードリポジトリに公開したりしないでください

エラー処理を実装

すべての可能なエラーコードを処理します、特に429（レート制限）と495（クレジット不足）

レート制限ヘッダーを監視

レスポンスヘッダーのX-RateLimit-Remainingをチェックして残りのクォータを把握

再試行メカニズムを実装

429エラーの場合、Retry-Afterヘッダーに基づいて指数バックオフ再試行を実装

プロンプトを最適化

明確で具体的なプロンプトはより良い生成結果をもたらします

画像を圧縮

アップロード前に画像を圧縮すると転送速度が向上し、帯域幅を節約できます

APIレート制限

API呼び出しはレート制限で保護されており、制限は登録プランによって異なります:

年
年間Advancedプラン
200 リクエスト/分
月
月間Advancedプラン
20 リクエスト/分

💡レスポンスヘッダーにはX-RateLimit-Limit、X-RateLimit-Remaining、X-RateLimit-Reset情報が含まれます

HomeAI ImageAI VideoAI ToolsMe