เอกสาร API gemini-3.1-flash-lite-image

gemini-3.1-flash-lite-image

รูปภาพGooglegemini-3.1-flash-lite-imagegemini-3.1-flash-lite-image

เปิด Playground จัดการคีย์ API

gemini-3.1-flash-lite-image

การยืนยันตัวตน

Base URL: https://api.dreamtoai.com
Authorization: Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
ชื่อโมเดล (model): gemini-3.1-flash-lite-image

โปรโตคอลการเชื่อมต่อ

ทำไมต้องเลือกโปรโตคอลนี้

适合原本使用 Gemini SDK 或 generateContent 接口的用户直接迁移。

URL เอนด์พอยต์

POST/v1beta/models/gemini-3.1-flash-lite-image:generateContent

Authorization: Bearer YOUR_API_KEYContent-Type: application/json

JSON คำขอและการตอบกลับ

ตัวอย่างคำขอ

ใช้ URL รูปภาพfileData.fileUri

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "生成一张产品海报，白色背景，商业摄影风格"
        },
        {
          "fileData": {
            "fileUri": "https://example.com/reference.png"
          }
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": [
      "IMAGE"
    ]
  }
}

ใช้ Base64inlineData.mimeType + inlineData.data

{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "生成一张产品海报，白色背景，商业摄影风格"
        },
        {
          "inlineData": {
            "mimeType": "image/jpeg",
            "data": "BASE64_IMAGE_DATA"
          }
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": [
      "IMAGE"
    ]
  }
}

ตัวอย่างการตอบกลับ

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "inlineData": {
              "mimeType": "image/png",
              "data": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mP8Xw8AAoMBgAqJvhoAAAAASUVORK5CYII="
            }
          }
        ]
      }
    }
  ],
  "modelVersion": "gemini-3.1-flash-lite-image",
  "usageMetadata": {
    "promptTokenCount": 8,
    "candidatesTokenCount": 16,
    "totalTokenCount": 24
  }
}

ฟิลด์คำขอและการตอบกลับ

ฟิลด์คำขอ

ฟิลด์	ประเภท	จำเป็น
contents	array	Y
contents[]	object	Y
contents[].role	string	Y
contents[].parts	array	Y
contents[].parts[]	object	Y
contents[].parts[].text	string	Y

ฟิลด์การตอบกลับ

ฟิลด์	ประเภท	จำเป็น
candidates[].content.parts[].inlineData.mimeType	string	N
candidates[].content.parts[].inlineData.data	image	N
usageMetadata.totalTokenCount	integer	N

ตัวอย่างโค้ด

cURLrequest.sh

curl -X POST "https://api.dreamtoai.com/v1beta/models/gemini-3.1-flash-lite-image:generateContent" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "生成一张产品海报，白色背景，商业摄影风格"
        },
        {
          "fileData": {
            "fileUri": "https://example.com/reference.png"
          }
        }
      ]
    }
  ]
}'

# cURL สำหรับอัปโหลดไฟล์อ้างอิง
curl -X POST "https://api.dreamtoai.com/v1/files/upload" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "kind=image" \
  -F "purpose=reference" \
  -F "[email protected]"