GemPix2 API概要
GemPix2画像生成APIは、テキストプロンプトと参照画像から高品質な画像を生成するGoogle Gemini AIモデルへのアクセスを提供します。GemPix2サービスは、包括的なタスク管理とコールバックサポートを備えたシンプルなRESTfulインターフェースを提供します。
GemPix2の主な機能
- • Google Gemini AIモデルを使用したGemPix2テキストから画像への生成
- • 参照画像のGemPix2サポート（最大4枚の画像）
- • ステータス追跡機能付きのGemPix2非同期タスク処理
- • リアルタイム通知のためのGemPix2 webhookコールバックサポート
- • JSON応答を含むGemPix2 RESTful API
- • GemPix2 Bearerトークン認証
overview.base_url
https://api.defapi.orgoverview.api_version
v1.0.0GemPix2の開始方法
- 1. 本番サーバーでGemPix2 APIキーに登録する
- 2. AuthorizationヘッダーにGemPix2 APIキーを含める
- 3. GemPix2画像生成エンドポイントにPOSTリクエストを送信する
- 4. 返されたGemPix2 task_idを使用して生成ステータスを確認する
- 5. タスクが完了したらGemPix2生成画像を取得する
認証
すべてのAPIリクエストは、Bearer トークン認証を使用して認証する必要があります。すべてのリクエストのAuthorizationヘッダーにAPIキーを含めてください。
認証方法
AuthorizationヘッダーにAPIキーを含めることで、HTTP Bearer トークン認証を使用します：
Authorization: Bearer <your-api-key>APIキー形式の例
Authorization: Bearer dk-1234567890abcdefリクエスト例
curl -X POST "https://api.defapi.org/api/image/gen" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer your-api-key-here" \
-d '{
"model": "google/gempix2",
"prompt": "A beautiful landscape"
}'有効な認証
- ✅ APIキーが有効です
- ✅ ユーザーアカウントがアクティブです
- ✅ 十分なクレジットが利用可能です
よくあるエラー
- ❌ APIキーがありません
- ❌ APIキーの形式が無効です
- ❌ 期限切れまたは非アクティブなアカウント
GemPix2 画像生成API
Google Gemini AIモデルとカスタマイズ可能なプロンプトおよび参照画像を使用して、GemPix2で画像を生成します。
エンドポイント
POST /api/image/genリクエストパラメータ
| Parameter | Type | Required | Description |
|---|---|---|---|
| model | string | Yes | Model identifier (e.g., "google/gempix2") |
| prompt | string | Yes | Text prompt describing the image |
| images | array | No | Reference image URLs (max 4) |
| callback_url | string | No | Webhook URL for completion notifications |
リクエスト例
基本的なGemPix2画像生成
{
"model": "google/gempix2",
"prompt": "A beautiful girl dancing in a garden"
}参照画像を使用したGemPix2画像ベース生成
{
"model": "google/gempix2",
"prompt": "Put them in a basket",
"images": [
"https://cdn.openai.com/API/docs/images/body-lotion.png",
"https://cdn.openai.com/API/docs/images/soap.png"
],
"callback_url": "https://example.com/webhook/image-callback"
}レスポンス形式
{
"code": 0,
"message": "ok",
"data": {
"task_id": "ta12345678-1234-1234-1234-123456789abc"
}
}エラーレスポンス
400 - Bad Request
{"code": 1, "message": "failed", "detail": "prompt is required"}401 - Unauthorized
{"code": 1, "message": "Invalid API key"}GemPix2 タスククエリAPI
GemPix2画像生成エンドポイントから返されたタスクIDを使用して、GemPix2画像生成タスクのステータスと結果を照会します。
エンドポイント
GET /api/task/query?task_id=<task_id>クエリパラメータ
| Parameter | Type | Required | Description |
|---|---|---|---|
| task_id | string | Yes | Unique task identifier returned from generation endpoint |
リクエスト例
curl -X GET "https://api.defapi.org/api/task/query?task_id=ta823dfb-eaac-44fd-aec2-3e2c7ba8e071" \ -H "Authorization: Bearer your-api-key-here"
GemPix2タスクステータス値
pending - GemPix2タスクが作成され、処理待ちですsubmitted - GemPix2タスクが生成キューに送信されましたin_progress - GemPix2タスクを現在処理中ですsuccess - GemPix2タスクが正常完了し、画像が生成されましたfailed - エラーによりGemPix2タスクが失敗しましたエラーレスポンス
404 - Task Not Found
{"code": 1, "message": "task not found"}401 - Unauthorized
{"code": 401, "message": "Invalid API key"}GemPix2データモデル
APIレスポンスとリクエストで使用される全てのGemPix2データモデルとスキーマの完全なリファレンスです。
ImageGenResult
Represents a generated image result.
{
"image": "https://google.datas.systems/fileSystem/response_images/287/2025/08/29/1756432513771985292_2989.png"
}| Field | Type | Description |
|---|---|---|
| image | string | Image URL or base64 data URI |
CallbackPayload
Payload sent to the callback_url when task status changes to final states.
{
"result": [
{
"image": "https://google.datas.systems/fileSystem/response_images/287/2025/08/29/1756432513771985292_2989.png"
}
],
"status": "success",
"task_id": "ta5c9705-b8ae-4cb9-aa6f-97c4fee88c8d",
"consumed": "0.500000",
"status_reason": {
"message": null
}
}| Field | Type | Description |
|---|---|---|
| result | array | Array of ImageGenResult objects (null if failed) |
| status | string | Final task status (success/failed) |
| task_id | string | Unique task identifier |
| consumed | string | Credits consumed by the task |
| status_reason | object | Status details including error message if failed |
GemPix2利用可能モデル
google/gempix2Nano Banana image generation modelgoogle/gemini-2.5-flash-imageGemini 2.5 Flash image modelエラーハンドリング
エラーの処理方法とAPIレスポンスコードの理解に関する包括的なガイド。すべてのエラーレスポンスは一貫した形式に従っており、問題を効果的にトラブルシューティングできます。
HTTPステータスコード
200
OK
Request was successful
400
Bad Request
Invalid request parameters or malformed JSON
401
Unauthorized
Invalid, missing, or expired API key
404
Not Found
Task not found or endpoint doesn't exist
500
Internal Server Error
Server-side error occurred
エラーハンドリングのベストプラクティス
- 1. レスポンスボディを処理する前に、必ずHTTPステータスコードを確認する:
- 2. 500エラーに対するリトライロジックでは指数バックオフを実装する:
- 3. デバッグのために詳細情報付きでエラーレスポンスをログに記録する:
- 4. 400エラーを避けるため、リクエスト送信前に入力値を検証する:
- 5. 認証エラーが発生した場合は、ユーザーにAPIキーの更新を促す:
- 6. 頻繁にポーリングせず、定期的にタスクステータスを監視する:
- 7. タスク完了のポーリングを避けるため、可能な限りWebhookを使用する:
サンプルエラーハンドリング（JavaScript）
async function generateImage(prompt, apiKey) {
try {
const response = await fetch('https://api.defapi.org/api/image/gen', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'Authorization': `Bearer ${apiKey}`
},
body: JSON.stringify({
model: 'google/gempix2',
prompt: prompt
})
});
if (!response.ok) {
const errorData = await response.json();
throw new Error(`API Error ${response.status}: ${errorData.message}`);
}
const data = await response.json();
return data.data.task_id;
} catch (error) {
console.error('Image generation failed:', error.message);
throw error;
}
}