Format de discussion Google Gemini (générer du contenu)

📝Présentation

L'API Google Gemini prend en charge la génération de contenu à l'aide d'images, d'audio, de code, d'outils, etc. Étant donné l'entrée, GenerateContentRequest génère des réponses de modèle. Prend en charge la génération de texte, la compréhension visuelle, le traitement audio, le contexte long, l'exécution de code, le schéma JSON, l'appel de fonction et de nombreuses autres fonctionnalités.

💡 Exemples de requêtes

Chat textuel de base ✅

curl "https://88api.ai/v1beta/models/gemini-2.0-flash:generateContent?key=$API_KEY" \
    -H 'Content-Type: application/json' \
    -X POST \
    -d '{
      "contents": [{
        "parts":[{"text": "Write a story about a magic backpack."}]
        }]
       }' 2> /dev/null

Chat d'analyse d'images ✅

# Use temporary file to save base64 encoded image data
TEMP_B64=$(mktemp)
trap 'rm -f "$TEMP_B64"' EXIT
base64 $B64FLAGS $IMG_PATH > "$TEMP_B64"

# Use temporary file to save JSON payload
TEMP_JSON=$(mktemp)
trap 'rm -f "$TEMP_JSON"' EXIT

cat > "$TEMP_JSON" `<< EOF
{
  "contents": [{
    "parts":[
      {"text": "Tell me about this instrument"},
      {
        "inline_data": {
          "mime_type":"image/jpeg",
          "data": "$(cat "$TEMP_B64")"
        }
      }
    ]
  }]
}
EOF

curl "https://88api.ai/v1beta/models/gemini-2.0-flash:generateContent?key=$API_KEY" \
    -H 'Content-Type: application/json' \
    -X POST \
    -d "@$TEMP_JSON" 2>` /dev/null

Appel de fonction ✅

cat > tools.json `<< EOF
{
  "function_declarations": [
    {
      "name": "enable_lights",
      "description": "Turn on the lighting system."
    },
    {
      "name": "set_light_color",
      "description": "Set the light color. Lights must be enabled for this to work.",
      "parameters": {
        "type": "object",
        "properties": {
          "rgb_hex": {
            "type": "string",
            "description": "The light color as a 6-digit hex string, e.g. ff0000 for red."
          }
        },
        "required": [
          "rgb_hex"
        ]
      }
    },
    {
      "name": "stop_lights",
      "description": "Turn off the lighting system."
    }
  ]
}
EOF

curl "https://88api.ai/v1beta/models/gemini-2.0-flash:generateContent?key=$API_KEY" \
  -H 'Content-Type: application/json' \
  -d @<(echo '
  {
    "system_instruction": {
      "parts": {
        "text": "You are a helpful lighting system bot. You can turn lights on and off, and you can set the color. Do not perform any other tasks."
      }
    },
    "tools": ['$(cat tools.json)'],

    "tool_config": {
      "function_calling_config": {"mode": "auto"}
    },

    "contents": {
      "role": "user",
      "parts": {
        "text": "Turn on the lights please."
      }
    }
  }
') 2>`/dev/null |sed -n '/"content"/,/"finishReason"/p'

Réponse de schéma JSON ✅

curl "https://88api.ai/v1beta/models/gemini-2.0-flash:generateContent?key=$API_KEY" \
-H 'Content-Type: application/json' \
-d '{
    "contents": [{
      "parts":[
        {"text": "List 5 popular cookie recipes"}
        ]
    }],
    "generationConfig": {
        "response_mime_type": "application/json",
        "response_schema": {
          "type": "ARRAY",
          "items": {
            "type": "OBJECT",
            "properties": {
              "recipe_name": {"type":"STRING"},
            }
          }
        }
    }
}' 2> /dev/null | head

Traitement audio 🟡

# Use File API to upload audio data to API request
# Use base64 inline_data to upload audio data to API request
if [[ "$(base64 --version 2>&1)" = *"FreeBSD"* ]]; then
  B64FLAGS="--input"
else
  B64FLAGS="-w0"
fi
AUDIO_B64=$(base64 $B64FLAGS "$AUDIO_PATH")

curl "https://88api.ai/v1beta/models/gemini-2.0-flash:generateContent?key=$API_KEY" \
  -H 'Content-Type: application/json' \
  -X POST \
  -d '{
    "contents": [{
      "parts": [
        {"text": "Please describe this audio file."},
        {"inline_data": {"mime_type": "audio/mpeg", "data": "'$AUDIO_B64'"}}
      ]
    }]
  }' 2> /dev/null | jq ".candidates[].content.parts[].text"

Traitement vidéo 🟡

# Use File API to upload video data to API request
# Use base64 inline_data to upload video data to API request
if [[ "$(base64 --version 2>&1)" = *"FreeBSD"* ]]; then
  B64FLAGS="--input"
else
  B64FLAGS="-w0"
fi
VIDEO_B64=$(base64 $B64FLAGS "$VIDEO_PATH")

curl "https://88api.ai/v1beta/models/gemini-2.0-flash:generateContent?key=$API_KEY" \
  -H 'Content-Type: application/json' \
  -X POST \
  -d '{
    "contents": [{
      "parts": [
        {"text": "Transcribe the audio from this video and provide visual descriptions."},
        {"inline_data": {"mime_type": "video/mp4", "data": "'$VIDEO_B64'"}}
      ]
    }]
  }' 2> /dev/null | jq ".candidates[].content.parts[].text"

Traitement PDF 🟡

MIME_TYPE=$(file -b --mime-type "${PDF_PATH}")
# Upload a PDF to the API request with base64 inline_data
if [[ "$(base64 --version 2>&1)" = *"FreeBSD"* ]]; then
  B64FLAGS="--input"
else
  B64FLAGS="-w0"
fi
PDF_B64=$(base64 $B64FLAGS "$PDF_PATH")

echo $MIME_TYPE

curl "https://88api.ai/v1beta/models/gemini-2.0-flash:generateContent?key=$API_KEY" \
  -H 'Content-Type: application/json' \
  -X POST \
  -d '{
    "contents": [{
      "parts": [
        {"text": "Can you add a few more lines to this poem?"},
        {"inline_data": {"mime_type": "application/pdf", "data": "'$PDF_B64'"}}
      ]
    }]
  }' 2> /dev/null | jq ".candidates[].content.parts[].text"

Boîte de dialogue de discussion ✅

curl https://88api.ai/v1beta/models/gemini-2.0-flash:generateContent?key=$API_KEY \
    -H 'Content-Type: application/json' \
    -X POST \
    -d '{
      "contents": [
        {"role":"user",
         "parts":[{
           "text": "Hello"}]},
        {"role": "model",
         "parts":[{
           "text": "Great to meet you. What would you like to know?"}]},
        {"role":"user",
         "parts":[{
           "text": "I have two dogs in my house. How many paws are in my house?"}]},
      ]
    }' 2> /dev/null | grep "text"

Réponse en streaming ✅

curl "https://88api.ai/v1beta/models/gemini-2.0-flash:streamGenerateContent?alt=sse&key=$API_KEY" \
    -H 'Content-Type: application/json' \
    --no-buffer \
    -d '{
      "contents": [{
        "parts": [{"text": "Write a story about a magic backpack"}]
      }]
    }'

Exécution de code ✅

curl "https://88api.ai/v1beta/models/gemini-2.0-flash:generateContent?key=$API_KEY" \
    -H 'Content-Type: application/json' \
    -X POST \
    -d '{
      "contents": [{
        "parts": [{"text": "Calculate the Fibonacci Sequence10item"}]
      }],
      "tools": [{
        "codeExecution": {}
      }]
    }'

Configuration de génération ✅

curl https://88api.ai/v1beta/models/gemini-2.0-flash:generateContent?key=$API_KEY \
    -H 'Content-Type: application/json' \
    -X POST \
    -d '{
        "contents": [{
            "parts":[
                {"text": "Explain how AI works"}
            ]
        }],
        "generationConfig": {
            "stopSequences": [
                "Title"
            ],
            "temperature": 1.0,
            "maxOutputTokens": 800,
            "topP": 0.8,
            "topK": 10
        }
    }'  2> /dev/null | grep "text"

Paramètres de sécurité ✅

echo '{
    "safetySettings": [
        {"category": "HARM_CATEGORY_HARASSMENT", "threshold": "BLOCK_ONLY_HIGH"},
        {"category": "HARM_CATEGORY_HATE_SPEECH", "threshold": "BLOCK_MEDIUM_AND_ABOVE"}
    ],
    "contents": [{
        "parts":[{
            "text": "'I support Martians Soccer Club and I think Jupiterians Football Club sucks! Write a ironic phrase about them.'"}]}]}' > request.json

curl "https://88api.ai/v1beta/models/gemini-2.0-flash:generateContent?key=$API_KEY" \
    -H 'Content-Type: application/json' \
    -X POST \
    -d @request.json 2> /dev/null

Instruction système ✅

curl "https://88api.ai/v1beta/models/gemini-2.0-flash:generateContent?key=$API_KEY" \
-H 'Content-Type: application/json' \
-d '{ "system_instruction": {
    "parts":
      { "text": "You are a cat. Your name is Neko."}},
    "contents": {
      "parts": {
        "text": "Hello there"}}}'

📮 Demande

Points de terminaison

Générer du contenu

POST https://88api.ai/v1beta/{model=models/*}:generateContent

Stream Générer du contenu

POST https://88api.ai/v1beta/{model=models/*}:streamGenerateContent

Méthode d'authentification

Incluez la clé API dans l'URL de la requête:

?key=$API_KEY

Où $API_KEY est votre clé API Google AI.

Paramètres du chemin

model

• Type : chaîne
• Obligatoire : oui

Le nom du modèle pour lequel générer des complétions.

Format : models/{model}, par ex. models/gemini-2.0-flash

Paramètres du corps de la requête

contents

• Type: tableau
• Obligatoire : oui

Le contenu de la conversation en cours avec le modèle. Pour une requête à tour unique, il s’agit d’une instance unique. Pour les requêtes multitours de type chat, il s'agit d'un champ répété contenant l'historique de la conversation et la dernière requête.

Content object properties:

Part object properties:

InlineData object properties:

FileData object properties:

tools

• Type: tableau
• Obligatoire : non

Liste des outils que le modèle peut utiliser pour générer la réponse suivante. Les outils pris en charge incluent les fonctions et l'exécution de code.

Tool object properties:

FunctionDeclaration object properties:

FunctionCall object properties:

FunctionResponse object properties:

ExecutableCode object properties:

CodeExecutionResult object properties:

CodeExecution object properties:

toolConfig

• Type : objet
• Obligatoire : non

Configuration des outils pour tous les outils spécifiés dans la demande.

ToolConfig object properties:

FunctionCallingConfig object properties:

FunctionCallingMode enum values:

• MODE_UNSPECIFIED: Mode par défaut, le modèle décide s'il doit appeler une fonction
• AUTO: le modèle décide automatiquement quand appeler une fonction
• ANY: Le modèle doit appeler une fonction
• NONE: Le modèle ne peut pas appeler une fonction

safetySettings

• Type: tableau
• Obligatoire : non

Une liste d’instances SafetySetting pour filtrer le contenu dangereux.

SafetySetting object properties:

HarmCategory enum values:

• HARM_CATEGORY_HARASSMENT: Contenu de harcèlement
• HARM_CATEGORY_HATE_SPEECH: Discours et contenus haineux
• HARM_CATEGORY_SEXUALLY_EXPLICIT: Contenu explicitement sexuel
• HARM_CATEGORY_DANGEROUS_CONTENT : Contenu dangereux
• HARM_CATEGORY_CIVIC_INTEGRITY: Contenu susceptible d'être utilisé pour porter atteinte à l'intégrité civique

HarmBlockThreshold enum values:

• BLOCK_LOW_AND_ABOVE : Permet de publier des contenus ayant un score NÉGLIGIBLE
• BLOCK_MEDIUM_AND_ABOVE : Permet de publier des contenus avec un score NÉGLIGIBLE et FAIBLE
• BLOCK_ONLY_HIGH: Permet de publier des contenus présentant un niveau de risque NÉGLIGIBLE, FAIBLE et MOYEN
• BLOCK_NONE: autorise tous les contenus
• OFF: désactive les filtres de sécurité

Complete HarmBlockThreshold enum values:

• HARM_BLOCK_THRESHOLD_UNSPECIFIED : Seuil non renseigné
• BLOCK_LOW_AND_ABOVE: Bloque le contenu nuisible avec une probabilité moyenne ou supérieure, autorisant uniquement le contenu de niveau NÉGLIGIBLE
• BLOCK_MEDIUM_AND_ABOVE: Bloque le contenu nuisible avec une probabilité moyenne ou supérieure, autorisant le contenu de niveau NÉGLIGIBLE et FAIBLE
• BLOCK_ONLY_HIGH: bloque uniquement les contenus nuisibles avec une probabilité élevée, autorisant les contenus de niveau NÉGLIGIBLE, FAIBLE et MOYEN
• BLOCK_NONE: Ne bloque aucun contenu, autorisant tous les niveaux
• OFF: désactive complètement les filtres de sécurité

systemInstruction

• Type : objet (Contenu)
• Obligatoire : non

Instruction système définie par le développeur. Actuellement, ne prend en charge que le texte.

generationConfig

• Type : objet
• Obligatoire : non

Options de génération de modèle et de configuration de sortie.

GenerationConfig object properties:

Supported MIME types:

• text/plain: (par défaut) Sortie texte
• application/json : réponse JSON
• text/x.enum: ENUM comme réponse sous forme de chaîne

Modality enum values:

• TEXT: indique que le modèle doit renvoyer du texte
• IMAGE: indique que le modèle doit renvoyer l'image
• AUDIO: Indique que le modèle doit renvoyer l'audio

Schema object properties:

Type enum values:

• TYPE_UNSPECIFIED : Type non précisé
• STRING : Type de chaîne
• NUMBER: Type de numéro
• INTEGER : Type entier
• BOOLEAN : Type booléen
• ARRAY: Type de tableau
• OBJECT : Type d'objet

Supported programming languages (ExecutableCode):

• LANGUAGE_UNSPECIFIED : Langue non précisée
• PYTHON : langage de programmation Python

Code execution result enum (Outcome):

• OUTCOME_UNSPECIFIED : Résultat non précisé
• OUTCOME_OK: exécution du code réussie
• OUTCOME_FAILED: échec de l'exécution du code
• OUTCOME_DEADLINE_EXCEEDED: l'exécution du code a expiré

cachedContent

• Type : chaîne
• Obligatoire : non

Nom du contenu mis en cache, utilisé comme contexte pour fournir des prédictions. Format: cachedContents/{cachedContent}

📥 Réponse

Générer une réponse de contenu

Réponse à partir de modèles prenant en charge plusieurs réponses candidates. Le système rapporte les évaluations de sécurité et le filtrage du contenu pour l'invite et chaque candidat.

candidates

• Type: tableau
• Description: Liste des réponses candidates du modèle

Candidate object properties:

FinishReason enum values:

• STOP : Point d'arrêt naturel ou séquence d'arrêt prévue pour le modèle
• MAX_TOKENS: Limite maximale de tokens spécifiée dans la requête atteinte
• SAFETY: Répondre au contenu du candidat marqué pour des raisons de sécurité
• RECITATION: Répondre au contenu du candidat marqué pour des raisons de récitation
• LANGUAGE: Répondez au contenu du candidat marqué pour l'utilisation d'une langue non prise en charge
• OTHER: Raison inconnue
• BLOCKLIST: Opération de génération de token arrêtée car le contenu contient des mots interdits
• PROHIBITED_CONTENT: opération de génération de jeton arrêtée car le contenu peut contenir du contenu interdit
• SPII: opération de génération de jeton arrêtée car le contenu peut contenir des informations personnelles sensibles
• MALFORMED_FUNCTION_CALL: Appel de fonction généré par le modèle invalide
• IMAGE_SAFETY: la génération du jeton s'est arrêtée car l'image générée a violé les règles de sécurité

promptFeedback

• Type : objet
• Description: commentaires rapides liés au filtrage de contenu

PromptFeedback object properties:

BlockReason enum values:

• BLOCK_REASON_UNSPECIFIED : Valeur par défaut, cette valeur n'est pas utilisée
• SAFETY: invite du système bloquée pour des raisons de sécurité
• OTHER: Invite bloquée pour des raisons inconnues
• BLOCKLIST: le système a bloqué cette invite car elle contenait des termes dans la liste de blocage
• PROHIBITED_CONTENT: le système a bloqué cette invite car elle contenait du contenu interdit
• IMAGE_SAFETY: Image du candidat bloquée car elle générait du contenu dangereux

usageMetadata

• Type : objet
• Description: Métadonnées sur l'utilisation du jeton pour la demande de génération

UsageMetadata object properties:

modelVersion

• Type : chaîne
• Description: Version du modèle utilisée pour générer la réponse

responseId

• Type : chaîne
• Description: ID pour chaque réponse

Exemple de réponse complète

{
  "candidates": [
    {
      "content": {
        "parts": [
          {
            "text": "Hello！I am Gemini，one by Google Developed artificial intelligence assistant。I can help you answer your questions、provide information、Assistance with writing、Various tasks such as coding and programming。Please tell me what I can do for you！"
          }
        ],
        "role": "model"
      },
      "finishReason": "STOP",
      "index": 0,
      "safetyRatings": [
        {
          "category": "HARM_CATEGORY_SEXUALLY_EXPLICIT",
          "probability": "NEGLIGIBLE",
          "blocked": false
        },
        {
          "category": "HARM_CATEGORY_HATE_SPEECH",
          "probability": "NEGLIGIBLE",
          "blocked": false
        },
        {
          "category": "HARM_CATEGORY_HARASSMENT",
          "probability": "NEGLIGIBLE",
          "blocked": false
        },
        {
          "category": "HARM_CATEGORY_DANGEROUS_CONTENT",
          "probability": "NEGLIGIBLE",
          "blocked": false
        }
      ],
      "tokenCount": 47
    }
  ],
  "promptFeedback": {
    "safetyRatings": [
      {
        "category": "HARM_CATEGORY_SEXUALLY_EXPLICIT",
        "probability": "NEGLIGIBLE"
      },
      {
        "category": "HARM_CATEGORY_HATE_SPEECH",
        "probability": "NEGLIGIBLE"
      }
    ]
  },
  "usageMetadata": {
    "promptTokenCount": 4,
    "candidatesTokenCount": 47,
    "totalTokenCount": 51,
    "promptTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 4
      }
    ],
    "candidatesTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 47
      }
    ]
  },
  "modelVersion": "gemini-2.0-flash",
  "responseId": "response-12345"
}

🔧 Fonctionnalités avancées

Évaluations de sécurité

SafetyRating object properties:

HarmProbability enum values:

• NEGLIGIBLE : Probabilité nocive négligeable
• LOW: Probabilité nocive faible
• MEDIUM : Probabilité moyenne nocive
• HIGH: Probabilité nocive élevée

Métadonnées des citations

CitationMetadata object properties:

CitationSource object properties:

Exécution de code

Lorsque les outils d'exécution de code sont activés, le modèle peut générer et exécuter du code pour résoudre des problèmes.

Code execution example response:

{
  "candidates": [
    {
      "content": {
        "parts": [
          {
            "text": "Let me calculate the Fibonacci sequence10item："
          },
          {
            "executableCode": {
              "language": "PYTHON",
              "code": "def fibonacci(n):\n    if n <= 1:\n        return n\n    else:\n        return fibonacci(n-1) + fibonacci(n-2)\n\nresult = fibonacci(10)\nprint(f'No.10The term Fibonacci number is: {result}')"
            }
          },
          {
            "codeExecutionResult": {
              "outcome": "OK",
              "output": "No.10The term Fibonacci number is: 55"
            }
          },
          {
            "text": "So the Fibonacci sequence number10The item is55。"
          }
        ],
        "role": "model"
      },
      "finishReason": "STOP"
    }
  ]
}

Mise à la terre

GroundingMetadata object properties:

GroundingAttribution object properties:

AttributionSourceId object properties:

GroundingPassageId object properties:

SemanticRetrieverChunk object properties:

SearchEntryPoint object properties:

Segment object properties:

RetrievalMetadata object properties:

GroundingChunk object properties:

Web object properties:

GroundingSupport object properties:

Traitement multimodal

L'API Gemini prend en charge le traitement de plusieurs modalités d'entrée et de sortie:

Supported input modalities:

• TEXT: Texte pur
• IMAGE: Images (JPEG, PNG, WebP, HEIC, HEIF)
• AUDIO: Audio (WAV, MP3, AIFF, AAC, OGG, FLAC)
• VIDEO: Vidéos (MP4, MPEG, MOV, AVI, FLV, MPG, WEBM, WMV, 3GPP)
• DOCUMENT: Documents (PDF)

ModalityTokenCount object properties:

MediaResolution enum values:

• MEDIA_RESOLUTION_LOW: Basse résolution (64 jetons)
• MEDIA_RESOLUTION_MEDIUM: Résolution moyenne (256 jetons)
• MEDIA_RESOLUTION_HIGH : Haute résolution (256 jetons pour la mise à l'échelle et le recadrage)

Fonction de réflexion

ThinkingConfig object properties:

Génération vocale

SpeechConfig object properties:

VoiceConfig object properties:

PrebuiltVoiceConfig object properties:

MultiSpeakerVoiceConfig object properties:

SpeakerVoiceConfig object properties:

Supported language codes:

• zh-CN: chinois (simplifié)
• en-US: anglais (États-Unis)
• ja-JP : japonais
• ko-KR: coréen
• fr-FR: français
• de-DE: allemand
• es-ES : espagnol
• pt-BR: portugais (Brésil)
• hi-IN: hindi
• ar-XA: arabe
• it-IT: italien
• tr-TR: turc
• vi-VN: vietnamien
• th-TH: thaïlandais
• ru-RU: russe
• pl-PL : Polonais
• nl-NL: néerlandais

Résultats des problèmes de journalisation

LogprobsResult object properties:

TopCandidates object properties:

Candidate (Logprobs) object properties:

Fonction de récupération d'URL

UrlRetrievalMetadata object properties:

UrlRetrievalContext object properties:

UrlContextMetadata object properties:

UrlMetadata object properties:

UrlRetrievalStatus enum values:

• URL_RETRIEVAL_STATUS_SUCCESS: récupération de l'URL réussie
• URL_RETRIEVAL_STATUS_ERROR: la récupération de l'URL a échoué en raison d'une erreur

Catégories de préjudice complètes

HarmCategory enum values:

• HARM_CATEGORY_UNSPECIFIED : Catégorie non précisée
• HARM_CATEGORY_DEROGATORY : PaLM - Commentaires négatifs ou nuisibles ciblant l'identité et/ou les attributs protégés
• HARM_CATEGORY_TOXICITY: PaLM – Contenu grossier, impoli ou grossier
• HARM_CATEGORY_VIOLENCE : PaLM - Scénarios illustrant la violence contre des individus ou des groupes
• HARM_CATEGORY_SEXUAL : PaLM - Références à un comportement sexuel ou à tout autre contenu explicite
• HARM_CATEGORY_MEDICAL: PaLM - Promouvoir le conseil médical non vérifié
• HARM_CATEGORY_DANGEROUS: PaLM – Les contenus dangereux favorisent, encouragent ou facilitent les comportements nuisibles
• HARM_CATEGORY_HARASSMENT: Gémeaux – Contenu sur le harcèlement
• HARM_CATEGORY_HATE_SPEECH : Gémeaux – Discours et contenus haineux
• HARM_CATEGORY_SEXUALLY_EXPLICIT: Gémeaux – Contenu explicitement sexuel
• HARM_CATEGORY_DANGEROUS_CONTENT: Gémeaux - Contenu dangereux
• HARM_CATEGORY_CIVIC_INTEGRITY: Gémeaux – Contenu susceptible d'être utilisé pour porter atteinte à l'intégrité civique

HarmProbability enum values:

• HARM_PROBABILITY_UNSPECIFIED : Probabilité non précisée
• NEGLIGIBLE : Probabilité nocive négligeable
• LOW: Probabilité nocive faible
• MEDIUM : Probabilité moyenne nocive
• HIGH: Probabilité nocive élevée

Modality enum values:

• MODALITY_UNSPECIFIED : Modalité non précisée
• TEXT: Texte pur
• IMAGE : Image
• VIDEO : Vidéo
• AUDIO : Audio
• DOCUMENT: Document, par exemple PDF

MediaResolution enum values:

• MEDIA_RESOLUTION_UNSPECIFIED: résolution multimédia non définie
• MEDIA_RESOLUTION_LOW: résolution multimédia réglée sur faible (64 jetons)
• MEDIA_RESOLUTION_MEDIUM: Résolution multimédia réglée sur moyenne (256 jetons)
• MEDIA_RESOLUTION_HIGH: résolution multimédia réglée sur élevée (en utilisant 256 tokens pour la mise à l'échelle et le recadrage)

UrlRetrievalStatus enum values:

• URL_RETRIEVAL_STATUS_UNSPECIFIED : Valeur par défaut, cette valeur n'est pas utilisée
• URL_RETRIEVAL_STATUS_SUCCESS: récupération de l'URL réussie
• URL_RETRIEVAL_STATUS_ERROR: la récupération de l'URL a échoué en raison d'une erreur

🔍 Gestion des erreurs

Codes d'erreur courants

Explications détaillées des codes d'erreur

Exemple de réponse d'erreur

{
  "error": {
    "code": 400,
    "message": "Invalid argument: contents",
    "status": "INVALID_ARGUMENT",
    "details": [
      {
        "@type": "type.googleapis.com/google.rpc.BadRequest",
        "fieldViolations": [
          {
            "field": "contents",
            "description": "contents is required"
          }
        ]
      }
    ]
  }
}