LogoAPI in One
Dashboard

API Dokümantasyonu

API in One'ı uygulamanıza entegre etmek için ihtiyacınız olan her şey.

Kimlik Doğrulama

Tüm API istekleri, Authorization başlığında bir Bearer token gerektirir. API anahtarlarınızı kontrol panelinden yönetebilirsiniz.

http
Authorization: Bearer aio_your_api_key_here

API Anahtarınızı Alın: Kontrol panelinizdeki API Anahtarları sayfasından ücretsiz API anahtarınızı oluşturun. Yeni hesaplar platformu keşfetmek için bonus kredi alır.

Temel URL

https://apiin.one/api/v1

API Uç Noktaları

POST/api/v1/images/generations
POST/api/v1/videos/generations
POST/api/v1/audio/music
POST/api/v1/audio/speech
POST/api/v1/chat/completions
POST/api/v1/images/tools/remove-bg
GET/api/v1/tasks/{task_id}

İstek Formatı

Tüm istekler, hangi AI modelinin kullanılacağını belirten zorunlu bir 'model' alanı içeren JSON gövdesi kullanır. Ek parametreler modele göre değişir.

json
{
  "model": "flux-2",
  "prompt": "A beautiful landscape",
  "...other_params": "..."
}

'model' parametresi her zaman zorunludur. Desteklenen parametrelerin tam listesi için her modelin dokümantasyon sayfasını ziyaret edin.

Yanıt Formatı

Asenkron Görevler (Görsel, Video, Müzik, Ses)

İçerik oluşturma modelleri için API hemen bir görev ID'si döndürür. Görevin tamamlanıp tamamlanmadığını kontrol etmek için durum uç noktasını sorgulayın.

Initial response when task is created.

{
  "id": "task_abc123",
  "status": "pending",
  "model": "kling-3",
  "created_at": "2026-02-24T12:00:00Z"
}

Senkron Yanıtlar (Sohbet)

Sohbet yanıtları, OpenAI uyumlu formatta tek bir istekte doğrudan döndürülür.

json
{
  "id": "chatcmpl_xyz",
  "model": "gemini",
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": "..."
      }
    }
  ],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 156,
    "total_tokens": 168
  },
  "credits_consumed": 2
}

Hata İşleme

Tüm hatalar, hata kodu, mesaj ve tür içeren tutarlı bir JSON formatında döndürülür.

json
{
  "error": {
    "code": 401,
    "message": "Invalid API key",
    "type": "authentication_error"
  }
}
Status CodeTürGerekliAçıklama
400invalid_requestİsteğe BağlıGeçersiz istek parametreleri. Zorunlu alanlar için model dokümantasyonunu kontrol edin.
401authentication_errorİsteğe BağlıAPI anahtarı eksik, geçersiz veya iptal edilmiş.
402insufficient_creditsİsteğe BağlıHesabınızda yeterli kredi yok. Devam etmek için daha fazla kredi satın alın.
404not_foundİsteğe Bağlıİstenen kaynak (görev, model) bulunamadı.
429rate_limitİsteğe BağlıHız sınırı aşıldı. Varsayılan dakikada 60 istektir.
500server_errorİsteğe BağlıDahili sunucu hatası. Lütfen kısa bir süre sonra tekrar deneyin.

Hızlı Başlangıç

1. API anahtarınızı alın

Kaydolun ve kontrol panelinizden bir API anahtarı oluşturun. Ücretsiz hesaplar bonus kredi içerir.

2. İlk isteğinizi gönderin

bash
curl -X POST https://apiin.one/api/v1/images/generations \
  -H "Authorization: Bearer aio_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-2",
    "prompt": "A serene Japanese garden with cherry blossoms"
  }'

3. Görev durumunu kontrol edin (asenkron modeller)

bash
curl https://apiin.one/api/v1/tasks/task_abc123 \
  -H "Authorization: Bearer aio_your_key"

4. Daha fazla model keşfedin

Kullanım durumunuz için mükemmel AI modelini bulmak üzere model dizinimize göz atın.

Tüm modellere göz at →

API Tester

Test the API directly from your browser:

API AlanıPOST