Gemini tạo ra hình ảnh (định dạng gốc)

Sử dụng giao diện generateContent gốc của Gemini để tạo hình ảnh. Với mô hình hỗ trợ hình ảnh như gemini-2.5-flash-image, hình ảnh được trả về dưới dạng base64 trong parts[].inlineData.

Chia sẻ cùng một điểm cuối /v1beta/models/{model}:generateContent như cuộc trò chuyện văn bản, ngoại trừ việc sử dụng mô hình hình ảnh và khai báo IMAGE in generationConfig.responseModalities. Khi hình ảnh và văn bản được trộn lẫn, TEXT có thể được trả lại cùng một lúc.

POST /v1beta/models/{model}:generateContent https://api.covanexus.com

Authorization

Nội dung

Authorization

Authorization BearerAuth

Authorization Bearer

Sử dụng xác thực Bearer Token: Authorization: Bearer $COVA_NEXUS_API_KEY. Cũng tương thích với kiểu Gemini x-goog-api-key: $COVA_NEXUS_API_KEY tiêu đề yêu cầu.

in: tiêu đề

Nội dung yêu cầu

application/json

contents* array[object]

Tạo gợi ý cho mỗi role and parts (văn bản, hoặc inlineData hình ảnh cho đồ họa)

generationConfig? object

Tạo cấu hình. responseModalities là bắt buộc để vẽ, chẳng hạn như ["TEXT","IMAGE"] or ["IMAGE"]; imageConfig.aspectRatio (chẳng hạn như "1:1", "16:9"), v.v. cũng được hỗ trợ.

systemInstruction? object

Hướng dẫn cấp hệ thống (bao gồm cả các bộ phận)

safetySettings? array[object]

Cài đặt lọc an toàn

Nội dung phản hồi

Mã trạng thái	Kiểu
200	application/json
400	application/json
429	application/json

curl -X POST \
  "https://api.covanexus.com/v1beta/models/gemini-2.5-flash-image:generateContent" \
  -H "Authorization: Bearer $COVA_NEXUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "contents": [
    {"role": "user", "parts": [{"text": "Vẽ một chú chó Shiba đội mũ nồi"}]}
  ],
  "generationConfig": {"responseModalities": ["TEXT", "IMAGE"]}
}'

const res = await fetch(
  "https://api.covanexus.com/v1beta/models/gemini-2.5-flash-image:generateContent",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer $COVA_NEXUS_API_KEY",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      contents: [
        { role: "user", parts: [{ text: "Vẽ một chú chó Shiba đội mũ nồi" }] }
      ],
      generationConfig: { responseModalities: ["TEXT", "IMAGE"] }
    })
  }
);
const data = await res.json();
const img = data.candidates[0].content.parts
  .find(p => p.inlineData)?.inlineData.data; // base64

import base64, requests

url = ("https://api.covanexus.com/v1beta/models/"
       "gemini-2.5-flash-image:generateContent")
resp = requests.post(
    url,
    headers={"Authorization": "Bearer $COVA_NEXUS_API_KEY"},
    json={
        "contents": [
            {"role": "user", "parts": [{"text": "Vẽ một chú chó Shiba đội mũ nồi"}]}
        ],
        "generationConfig": {"responseModalities": ["TEXT", "IMAGE"]}
    }
)
for part in resp.json()["candidates"][0]["content"]["parts"]:
    if "inlineData" in part:
        with open("out.png", "wb") as f:
            f.write(base64.b64decode(part["inlineData"]["data"]))

200

400

429

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "inlineData": {
              "mimeType": "image.png",
              "data": "<base64>"
            }
          }
        ]
      },
      "finishReason": "STOP",
      "index": 0
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 0,
    "candidatesTokenCount": 0,
    "totalTokenCount": 0
  }
}

BearerAuth