Resim Tanımlama API Dokümantasyonu (V2)

Giriş ve Kullanım Senaryoları

Resim Tanımlama API, yapay zeka destekli resim tanımlama yeteneklerini uygulamalarınıza entegre etmenizi sağlar. API'miz, resimleri analiz etmek ve detaylı açıklamalar oluşturmak için gelişmiş yapay zeka modelleri kullanır.

Yaygın Kullanım Senaryoları

Resimler için detaylı açıklamalar oluşturma
Resimlerden metin ve bilgi çıkarma
Resim içeriği ve bağlamını analiz etme
Yaratıcı yazım için karakter açıklamaları oluşturma
İçerik yönetimi için resim başlıkları oluşturma

API Anahtarları

API'mizi kullanmak için API kimlik bilgilerine (API Anahtarı ve Gizli Anahtar) ihtiyacınız olacak. API anahtarlarınızı kontrol panelinde yönetebilirsiniz.

API Anahtarlarını Yönet →

API Uç Noktası

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

Entegrasyon Kılavuzu

İstek Başlıkları

Başlık Adı	Gerekli	Açıklama
content-type	Evet	multipart/form-data olmalıdır
authorization	Evet	Bearer ${SECRET_KEY} olmalıdır ${SECRET_KEY} API anahtarınızdır.

İstek Parametreleri

Parametre	Tür	Gerekli	Açıklama
image	string veya file	Evet	Açıklama oluşturulacak resim. Üç giriş formatını kabul eder: 1. Resim URL'si, http:// veya https:// ile başlar. 2. Base64 Kodlanmış Resim, şu formatta: data:image/jpeg;base64,/9j/4AAQSkZJR... (Not: PNG gibi diğer resim türleri de mümkündür, mime-type'ı uygun şekilde ayarlayın) 3. Dosya Nesnesi: Model resmini temsil eden bir dosya nesnesi.
prompt	string	Evet	Resim analizi için özel istek
lang	string	Hayır	Yanıt dili (en/zh/de/es/fr/ja/ko/fi/nl/pt/tr/ru), varsayılan: en

Yanıt Formatı

Alan	Tür	Açıklama
code	number	Yanıt durum kodu. 200 başarı için
data	object	Yanıt veri nesnesi, code 200 olduğunda mevcut
data.content	string	Resim için oluşturulan açıklama
msg	string	Yanıt mesajı, ek bilgi sağlar
succeed	boolean	İsteğin başarılı olup olmadığını gösterir

Örnek Yanıt

{
    "code": 200,
    "data": {
        "content": "Resmin markdown formatında detaylı açıklaması..."
    },
    "succeed": true,
    "msg": "Başarılı"
}

Hata Kodları

Kod	Mesaj	Açıklama
200	OK	İstek başarılı
500	SERVER_ERROR	Sunucu iç hatası
10003	INSUFFICIENT_CREDITS	Yetersiz kredi
10004	INVALID_PARAM	Geçersiz parametreler
10005	HARMFUL_CONTENT	Zararlı içerik tespit edildi
30001	INVALID_API_KEY	Geçersiz API anahtarı
30002	INVALID_SIGNATURE	Geçersiz istek imzası

Kod Örnekleri

Resim URL'si ile Curl Örneği

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="Resmin içeriğini kısaca açıklayın"' \
--form 'lang="tr"'

Yerel Resim Dosyası ile Curl Örneği

curl --location 'https://imagedescriber.online/api/openapi-v2/describe-image' \
--header 'Authorization: Bearer ${SECRET_KEY}' \
--form 'image=@"/PATH/TO/YOUR/IMAGE.jpg"' \
--form 'prompt="Resmin içeriğini kısaca açıklayın"' \
--form 'lang="tr"'

Base64 Resim ile Curl Örneği

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="Resmin içeriğini kısaca açıklayın"' \
--form 'lang="tr"'

Node.js Örneği

async function callDescribeImageApi() {
  const apiKey = 'YOUR_API_KEY'; // Gerçek API anahtarınızla değiştirin

  const formData = new FormData();
  formData.append('image', ...); // url, resim dosyası, base64 kodlanmış resim destekler
  formData.append('prompt', 'Resmin içeriğini kısaca açıklayın');
  formData.append('lang', 'tr'); // Yanıt dili kodu

  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 || 'Bilinmeyen hata'}`);
    }

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

  } catch (error) {
    console.error('Resim açıklaması oluşturulurken hata:', error);
    return { content: null, error: error.message };
  }
}

Python Örneği

import requests
import base64

async def call_describe_image_api():
    api_key = 'YOUR_API_KEY'  # Gerçek API anahtarınızla değiştirin

    form_data = {
        'image': 'data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD...',  # Örnek Base64 resim. Gerçek resim verilerinizle değiştirin. url, dosya ve base64 destekler.
        'prompt': 'Resmin içeriğini kısaca açıklayın',
        'lang': 'tr' # Yanıt dili kodu
    }

    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) # multipart/form-data için files= kullanın
        response.raise_for_status()  # Hata durum kodları için istisna fırlatır (4xx veya 5xx)

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

    except requests.exceptions.RequestException as e:
        print(f'Resim açıklaması oluşturulurken hata: {e}')
        return {'content': None, 'error': str(e)}

Fiyatlandırma

API çağrıları hesabınızdaki kredileri tüketir. Fiyatlandırma sayfamızdan kredi satın alabilirsiniz.

Fiyatları Görüntüle →

Yardım ve Destek

Sorularınız varsa veya yardıma ihtiyacınız varsa, destek ekibimizle iletişime geçmekten çekinmeyin.

E-posta: [email protected]