Generate content | EmpirioLabs AI Docs

curl -X POST https://api.empiriolabs.ai/v1beta/models/qwen3-max:generateContent \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Explain quantum entanglement in one sentence."
        }
      ]
    }
  ],
  "systemInstruction": {
    "parts": [
      {
        "text": "You are a concise physics tutor."
      }
    ]
  },
  "generationConfig": {
    "temperature": 0.7,
    "maxOutputTokens": 256
  }
}'

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "text": "Quantum entanglement is a phenomenon where particles become interconnected so that the state of one instantly influences the state of another, regardless of distance.",
            "inlineData": {
              "mimeType": "image/png",
              "data": "iVBORw0KGgo="
            },
            "fileData": {
              "mimeType": "application/pdf",
              "fileUri": "https://example.com/quantum_entanglement_overview.pdf"
            },
            "functionCall": {
              "name": "fetchRelatedArticles",
              "args": {}
            },
            "functionResponse": {
              "name": "fetchRelatedArticles",
              "response": {}
            }
          }
        ]
      },
      "finishReason": "STOP",
      "index": 0
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 15,
    "candidatesTokenCount": 45,
    "totalTokenCount": 60,
    "thoughtsTokenCount": 0,
    "cachedContentTokenCount": 0
  },
  "modelVersion": "qwen3-max",
  "responseId": "resp_20240615_123456_abcdef"
}

Google Gemini-compatible endpoint. Send a native Gemini request (contents, systemInstruction, generationConfig, tools) and receive a native GenerateContentResponse. Point the google-genai SDK (Python or JavaScript) or any Gemini-native client at https://api.empiriolabs.ai and the SDK appends this path automatically. Authenticate with your EmpirioLabs API key via the x-goog-api-key header (or the ?key= query parameter). Works with any chat model, and pricing, parameters, and billing match /v1/chat/completions.

Google Gemini-compatible endpoint. Send a native Gemini request (`contents`, `systemInstruction`, `generationConfig`, `tools`) and receive a native `GenerateContentResponse`. Point the google-genai SDK (Python or JavaScript) or any Gemini-native client at `https://api.empiriolabs.ai` and the SDK appends this path automatically. Authenticate with your EmpirioLabs API key via the `x-goog-api-key` header (or the `?key=` query parameter). Works with any chat model, and pricing, parameters, and billing match `/v1/chat/completions`.

Authentication

AuthorizationBearer

Pass your EmpirioLabs API key as a bearer token. The Anthropic-style x-api-key header is also accepted on every endpoint.

Path parameters

modelstringRequired

An EmpirioLabs chat model id, for example qwen3-max.

Request

This endpoint expects an object.

contentslist of objectsRequired

Conversation turns. Roles are user and model.

systemInstructionobjectOptional

generationConfigobjectOptional

toolslist of objectsOptional

toolConfigobjectOptional

safetySettingslist of objectsOptional

Accepted for compatibility.

Response

Generated content.

candidateslist of objects

usageMetadataobject

modelVersionstring

responseIdstring

Errors

400

Bad Request Error

401

Unauthorized Error

402

Payment Required Error

429

Too Many Requests Error