Генерация изображений с Gemini (нативный формат)

Используйте нативный интерфейс Gemini generateContent для создания изображений. С моделью, поддерживающей генерацию изображений, например gemini-2.5-flash-image, результат возвращается в кодировке base64 внутри parts[].inlineData.

Используется та же конечная точка /v1beta/models/{model}:generateContent, что и для текстового диалога, но с моделью изображений и значением IMAGE в generationConfig.responseModalities. Если ответ содержит и текст, и изображения, TEXT также может возвращаться одновременно.

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

Аутентификация

Тело

Аутентификация

Authorization BearerAuth

Authorization Bearer <token>

Используйте аутентификацию по токену Bearer: Authorization: Bearer $COVA_NEXUS_API_KEY. Также поддерживается заголовок запроса x-goog-api-key: $COVA_NEXUS_API_KEY в формате Gemini.

в заголовке

Тело запроса

application/json

contents* array[object]

Генерируемое содержимое для каждой роли role и её parts (текст или inlineData для изображения)

generationConfig? object

Настройки генерации. responseModalities необходимо задать для создания изображений, например ["TEXT","IMAGE"] или ["IMAGE"]; imageConfig.aspectRatio (например, "1:1" или "16:9") также поддерживается.

systemInstruction? object

Системные инструкции и составляющие их части

safetySettings? array[object]

Настройки фильтрации безопасности

Тело ответа

Код состояния	Тип содержимого
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": "画一只戴贝雷帽的柴犬"}]}
  ],
  "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: "画一只戴贝雷帽的柴犬" }] }
      ],
      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": "画一只戴贝雷帽的柴犬"}]}
        ],
        "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