Yazıya dökme işinin durumu

GET/v1/transcriptions/{job_id}0 kredi

Bir yükleme işinin durumu ve tamamlandığında zamanlı transkripti; `format` ile tamamlanan transkript SRT, WebVTT veya metin dosyası olarak. İşi yalnızca dosyayı yükleyen hesap görür.

01Sorgu parametreleri

Ad	Tür	Açıklama
job_idzorunlu	string	`POST /v1/transcriptions` yanıtındaki iş kimliği (32 onaltılık karakter).
formatisteğe bağlı	string	`json` işi döndürür; `srt`, `vtt` veya `text` tamamlanan transkripti dosya olarak; `file` yüklemede verilen biçimde. Tamamlanmamış bir işin dosyası 409 `not_ready` döndürür.Varsayılan: `json`Kabul edilen değerler:`jsonsrtvtttextfile`

02Fiyatlandırma

Ücretsiz: işin fiyatı iş tamamlanınca alınır (buradaki `credits_charged` işin ücretidir).

03İstek

curl "https://api.scrapesocial.ai/v1/transcriptions/3f2a9c1e5b7d40a8b6c2e9f1a4d7b0c3" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

04Yanıtlar

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

GET /v1/transcriptions/8c51b6ab208c0f4c5fc98ea6740595a6

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "job_id": "8c51b6ab208c0f4c5fc98ea6740595a6",
  "status": "completed",
  "progress": 1,
  "created_at": "2026-10-25T17:13:48.300742Z",
  "started_at": "2026-10-25T17:13:48.304724Z",
  "finished_at": "2026-10-25T17:13:50.318084Z",
  "file_name": "interview.m4a",
  "file_bytes": 52955,
  "source_url": null,
  "duration_seconds": 6.277,
  "language": "en",
  "format": "srt",
  "credits_reserved": 1,
  "error": null,
  "status_url": "/v1/transcriptions/8c51b6ab208c0f4c5fc98ea6740595a6",
  "result": {
    "origin": "asr",
    "language": "en",
    "text": "Hello world. This is a short test of the Transcription Service. Thank you for listening.",
    "segments": [
      {
        "index": 1,
        "start": 0,
        "end": 6,
        "text": "Hello world. This is a short test of the Transcription Service. Thank you for listening."
      }
    ]
  }
}

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"
}

05Notlar

Yanıt: `job_id, status` (`queued`, `running`, `completed`, `failed`, `cancelled`), `progress` (konuşma parçalar halinde yazıya dökülürken 0 ile 1 arası, ölçülemediğinde null), `created_at, started_at, finished_at, file_name, file_bytes, duration_seconds, language, format, credits_reserved, credits_charged, error, status_url, result`. `result` tamamlanana kadar null'dır, sonra `{origin: asr, language, text, segments[{index, start, end, text}]}`. Başka bir hesabın işi, silinmiş veya süresi dolmuş bir iş ve hatalı bir kimlik 404 `not_found` döndürür. Servis yeniden başlarken çalışan bir iş başarısız sayılır ve kredisi iade edilir.

06Hatalar 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.