Afbeelding Beschrijven API Documentatie (V2)

Introductie & Gebruiksscenario's

De Afbeelding Beschrijven API stelt u in staat om AI-gestuurde afbeeldingsbeschrijvingsmogelijkheden te integreren in uw applicaties. Onze API gebruikt geavanceerde AI-modellen om afbeeldingen te analyseren en gedetailleerde beschrijvingen te genereren.

Veelvoorkomende Gebruiksscenario's

Genereer gedetailleerde beschrijvingen van afbeeldingen
Extraheer tekst en informatie uit afbeeldingen
Analyseer afbeeldingsinhoud en context
Maak karakterbeschrijvingen voor creatief schrijven
Genereer afbeeldingsbijschriften voor contentbeheer

API Sleutels

Om onze API te gebruiken, heeft u API-inloggegevens nodig (API-sleutel en Secret). U kunt uw API-sleutels beheren in het dashboard.

API Sleutels Beheren →

API Endpoint

POST https://imagedescriber.online/api/openapi-v2/describe-image

Integratiegids

Verzoekheaders

Header Naam	Vereist	Beschrijving
content-type	Ja	Moet multipart/form-data zijn
authorization	Ja	Moet Bearer ${SECRET_KEY} zijn ${SECRET_KEY} is uw API-sleutel.

Verzoekparameters

Parameter	Type	Vereist	Beschrijving
image	string of file	Ja	Afbeelding om beschrijving te genereren. Accepteert drie invoerformaten: 1. Afbeeldings-URL, beginnend met http:// of https://. 2. Base64 Gecodeerde Afbeelding, volgens het formaat: data:image/jpeg;base64,/9j/4AAQSkZJR... (Opmerking: andere afbeeldingstypen zoals PNG zijn ook mogelijk, pas het mime-type dienovereenkomstig aan) 3. Bestandsobject: Een bestandsobject dat de modelafbeelding vertegenwoordigt.
prompt	string	Ja	Aangepaste prompt voor afbeeldingsanalyse
lang	string	Nee	Antwoordtaal (en/zh/de/es/fr/ja/ko/fi/nl/pt/tr/ru), standaard: en

Antwoordformaat

Veld	Type	Beschrijving
code	number	Antwoordstatuscode. 200 voor succes
data	object	Antwoordgegevensobject, aanwezig wanneer code 200 is
data.content	string	De gegenereerde beschrijving voor de afbeelding
msg	string	Antwoordbericht, biedt aanvullende informatie
succeed	boolean	Geeft aan of het verzoek succesvol was

Voorbeeldantwoord

{
    "code": 200,
    "data": {
        "content": "Gedetailleerde beschrijving van de afbeelding in markdown-formaat..."
    },
    "succeed": true,
    "msg": "Succes"
}

Foutcodes

Code	Bericht	Beschrijving
200	OK	Verzoek succesvol
500	SERVER_ERROR	Interne serverfout
10003	INSUFFICIENT_CREDITS	Onvoldoende credits
10004	INVALID_PARAM	Ongeldige parameters
10005	HARMFUL_CONTENT	Schadelijke inhoud gedetecteerd
30001	INVALID_API_KEY	Ongeldige API-sleutel
30002	INVALID_SIGNATURE	Ongeldige verzoekhandtekening

Codevoorbeelden

Curl Voorbeeld met Afbeeldings-URL

curl --location 'https://imagedescriber.online/api/openapi-v2/describe-image' \
--header 'Authorization: Bearer ${SECRET_KEY}' \
--form 'image="https://persistent.imagedescriber.online/image-describer-examples/000.jpg"' \
--form 'prompt="Beschrijf kort de inhoud van de afbeelding"' \
--form 'lang="nl"'

Curl Voorbeeld met Lokaal Afbeeldingsbestand

curl --location 'https://imagedescriber.online/api/openapi-v2/describe-image' \
--header 'Authorization: Bearer ${SECRET_KEY}' \
--form 'image=@"/PATH/TO/YOUR/IMAGE.jpg"' \
--form 'prompt="Beschrijf kort de inhoud van de afbeelding"' \
--form 'lang="nl"'

Curl Voorbeeld met Base64 Afbeelding

curl --location 'https://imagedescriber.online/api/openapi-v2/describe-image' \
--header 'Authorization: Bearer ${SECRET_KEY}' \
--form 'image="data:image/jpeg;base64,/9j……/9k="' \
--form 'prompt="Beschrijf kort de inhoud van de afbeelding"' \
--form 'lang="nl"'

Node.js Voorbeeld

async function callDescribeImageApi() {
  const apiKey = 'YOUR_API_KEY'; // Vervang dit door uw werkelijke API-sleutel

  const formData = new FormData();
  formData.append('image', ...); // Ondersteunt url, afbeeldingsbestand, base64 gecodeerde afbeelding
  formData.append('prompt', 'Beschrijf kort de inhoud van de afbeelding');
  formData.append('lang', 'nl'); // Antwoordtaalcode

  const apiEndpoint = 'https://imagedescriber.online/api/openapi-v2/describe-image';
  try {
    const response = await fetch(apiEndpoint, {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${apiKey}`,
      },
      body: formData,
    });

    if (!response.ok) {
      const errorData = await response.json();
      throw new Error(`HTTP error ${response.status}: ${errorData.msg || 'Onbekende fout'}`);
    }

    const data = await response.json();
    return { content: data.data.content, error: null };

  } catch (error) {
    console.error('Fout bij het beschrijven van de afbeelding:', error);
    return { content: null, error: error.message };
  }
}

Python Voorbeeld

import requests
import base64

async def call_describe_image_api():
    api_key = 'YOUR_API_KEY'  # Vervang dit door uw werkelijke API-sleutel

    form_data = {
        'image': 'data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD...',  # Voorbeeld Base64 afbeelding. Vervang dit door uw werkelijke afbeeldingsgegevens. Ondersteunt url, bestand en base64.
        'prompt': 'Beschrijf kort de inhoud van de afbeelding',
        'lang': 'nl' # Antwoordtaalcode
    }

    api_endpoint = 'https://imagedescriber.online/api/openapi-v2/describe-image'
    try:
        headers = {
            'Authorization': f'Bearer {api_key}',
        }

        response = requests.post(api_endpoint, files=form_data, headers=headers) # Gebruik files= voor multipart/form-data
        response.raise_for_status()  # Genereert een uitzondering voor foutstatuscodes (4xx of 5xx)

        data = response.json()
        return {'content': data.get('data', {}).get('content'), 'error': None}

    except requests.exceptions.RequestException as e:
        print(f'Fout bij het beschrijven van de afbeelding: {e}')
        return {'content': None, 'error': str(e)}

Prijzen

API-aanroepen verbruiken credits van uw account. U kunt credits kopen op onze prijspagina.

Prijzen Bekijken →

Help & Ondersteuning

Als u vragen heeft of hulp nodig heeft, aarzel dan niet om contact op te nemen met ons ondersteuningsteam.

E-mail: [email protected]