Üretken Medya API'si

Bir istemden medya oluşturun ve kullanıcı bunu seçtiğinde sınırlı bir dizi Chainabit bağlamları. API asla "accountId", "chainerId" veya gövdedeki 'çalışma alanı kimliği'; bu değerler kimliği doğrulanmış istekten gelir.

Temel Yol

https://api.chainabit.com/api/v1/ai/generative-media

Bağlam Çalıştırması Oluşturma

Tanım

'ai.contextMedia.generate' ve eşleşen medya yetkisini gerektirir: "ai.image.generate", "ai.video.generate" veya "ai.audio.generate".

Rica etmek

• Başlıklar: Yetkilendirme: Taşıyıcı <token>, Content-Type: application/json

'sessionId' isteğe bağlıdır ve nesli mevcut bir sohbet oturumuna bağlar; Oturum Oluştur'daki "id"yi kullanın yanıt ('data.id') '$SESSION_ID' olarak.

{
  "prompt": "draw my life as a clean editorial poster",
  "mediaType": "image",
  "generationMode": "context_aware",
  "requestedContextSources": ["chainies", "bits"],
  "aspectRatio": "1:1",
  "sessionId": "$SESSION_ID"
}

'requestedContextSources', 'profil', 'tercihler', 'ayarlar' içerebilir "oturumlar", "zincirler", "bitler", "bellek", "çalışma alanı", "nesil_history" ve "uploaded_media".

Cevap

{
  "data": {
    "jobId": "550e8400-e29b-41d4-a716-446655440010",
    "status": "completed",
    "mediaType": "image",
    "generationMode": "context_aware",
    "permissionRequired": false,
    "allowedContextSources": ["chainies", "bits"],
    "blockedContextSources": [],
    "resultMediaId": "550e8400-e29b-41d4-a716-446655440020",
    "errorCode": null,
    "createdAt": "2026-05-22T10:00:00Z",
    "updatedAt": "2026-05-22T10:00:08Z"
  }
}

İstenen hiçbir kaynağa izin verilmiyorsa yanıt şunu kullanır: status: "permission_required" ve hiçbir kişisel bağlam alınmıyor.

Kod Örneği

POST /ai/generative-media/context-runs
Authorization: Bearer $TOKEN
Content-Type: application/json

İş Durumunu Oku

Rica etmek

• Başlıklar: Yetkilendirme: Taşıyıcı <token>
• Yol parametreleri: jobId

Aramanın kapsamı kimliği doğrulanmış kullanıcıya göre belirlenir.

Cevap

Başka bir kullanıcıya ait bir iş "data: null" değerini döndürür.

Kod Örneği

GET /ai/generative-media/context-runs/{jobId}
Authorization: Bearer $TOKEN

İzinleri Oku

Rica etmek

• Başlıklar: Yetkilendirme: Taşıyıcı <token>

Cevap

{
  "data": {
    "allowPersonalizedGeneration": true,
    "perSource": {
      "profile": false,
      "preferences": true,
      "settings": false,
      "sessions": false,
      "chainies": true,
      "bits": true,
      "memory": false,
      "workspace": false,
      "generation_history": false,
      "uploaded_media": false
    },
    "capturedAt": "2026-05-22T10:00:00Z"
  }
}

Kod Örneği

GET /ai/generative-media/permissions
Authorization: Bearer $TOKEN

İzinleri Güncelle

Rica etmek

• Başlıklar: Yetkilendirme: Taşıyıcı <token>, Content-Type: application/json

{
  "personalizedGeneration": true,
  "chainies": true,
  "bits": true,
  "memory": false
}

Yalnızca dahil edilen anahtarlar güncellenir. Bu izin işaretleri sohbetten ayrıdır bellek tercihleri, dolayısıyla AI belleğin etkinleştirilmesi otomatik olarak izin vermez üretken medya kişiselleştirmesi.

Cevap

Kod Örneği

PATCH /ai/generative-media/permissions
Authorization: Bearer $TOKEN
Content-Type: application/json