Yükleme bağlantısı oluştur

POST/v1/transcriptions/uploads0 kredi

Yazıya dökülecek bir dosyayı doğrudan depolamamıza koymak için bir bağlantı alın; 2 GB'a kadar dosyalar için (doğrudan yükleme en fazla 99 MB alır). Dosyayı verilen başlıklarla `upload_url` adresine PUT edin, sonra `upload_id` ile Bir dosyayı veya Twitch VOD'unu yazıya dök'ü çağırın. Ücretsizdir. Bize ait bir rota.

01Sorgu parametreleri

Ad	Tür	Açıklama
sizezorunlu	integer	Dosyanın bayt cinsinden tam boyutu; bağlantı tam olarak bu kadarını kabul eder (en fazla 2 GB). JSON veya form gövdesinde de kabul edilir.
content_typeisteğe bağlı	string	Dosyanın medya türü (örneğin `audio/mpeg`, `video/mp4`); PUT isteğinde aynı `Content-Type` başlığını gönderin. JSON veya form gövdesinde de kabul edilir.Varsayılan: `application/octet-stream`

02İstek

curl -X POST "https://api.scrapesocial.ai/v1/transcriptions/uploads?size=52428800&content_type=audio%2Fmpeg" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Yanıtlar

API'nin gerçek yanıtları. Listeler 2 öğeye kısaltılmıştır.

POST /v1/transcriptions/uploads?size=105102102&content_type=audio%2Fwav

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 0,
  "upload_id": "b7fbc52fdc208861e08e944ae314700d",
  "method": "PUT",
  "upload_url": "https://7ff07f9ec021e94e148c0683772bfd57.eu.r2.cloudflarestorage.com/scrapesocial-cdn/uploads/2/b7fbc52fdc208861e08e944ae314700d?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=04874dc46851b52326b9130e9dee8b12%2F20261025%2Fauto%2Fs3%2Faws4_request&X-Amz-Date=20261025T225827Z&X-Amz-Expires=900&X-Amz-SignedHeaders=content-length%3Bcontent-type%3Bhost&x-id=PutObject&X-Amz-Signature=e826c1662913a439…",
  "headers": {
    "Content-Type": "audio/wav"
  },
  "size": 105102102,
  "expires_at": "2026-10-25T23:13:27Z"
}

Tüm uç noktalarda ortak

Her rota bunları döndürebilir: eksik ya da hatalı anahtar, biten kredi, yanıt vermeyen platform ya da bizim tarafımızdaki bir hata. Hiçbiri kredi harcamaz.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

04Notlar

Yanıt: `upload_id`, `method: PUT`, `upload_url`, `headers` (PUT ile gönderin), `size`, `expires_at`. Bağlantı 15 dakika geçerlidir ve tam olarak `size` bayt kabul eder; depolama başka bir gövdeyi reddeder. Sonra örneğin `curl -X PUT -H 'Content-Type: audio/mpeg' --data-binary @talk.mp3 "<upload_url>"` ve `{"upload_id": "…"}` ile `POST /v1/transcriptions`: fiyat o anda, doğrudan yüklemedeki gibi dosyanın süresinden belirlenir. Bir yükleme bir iş yapar ve iş oluşturulurken depolamadan silinir; hiç kullanılmayan bir yükleme bir gün sonra silinir. Retler, hepsi ücretsiz: 400 `missing_parameter` (size yok), 400 `bad_request` (0'dan büyük tam sayı olmayan bir size, hatalı bir content_type), 413 `file_too_large` (2 GB'tan büyük).

05Hatalar ve krediler

Her hatada success: false ve gerçek bir HTTP durum kodu döner; kredi düşmez.

400missing_parameter
Zorunlu bir parametre eksik veya geçersiz.
403private_account
Hesap gizli ya da yaş kısıtlamalı.
404not_found
Böyle bir hesap yok.
503upstream_error
Platform şu an cevap vermiyor; tekrar deneyin.