GeoCaption

Developer API

beta

GeoCaption REST API-ის საშუალებით შეგიძლიათ ქართული სუბტიტრების გენერაცია ინტეგრირება ნებისმიერ პროდუქტში.

API-ი beta ფაზაშია — ყველა endpoint-ზე წვდომა მოითხოვს Pro გეგმას.

1დასაწყებად — API გასაღები

  1. 1გახსენით /profile გვერდი და გადადით API ჩანართზე.
  2. 2დააჭირეთ "ახალი გასაღების გენერაცია" — შეინახეთ, ერთხელ გამოჩნდება.
  3. 3გამოიყენეთ გასაღები ყველა API მოთხოვნაში Authorization header-ში.
API გასაღების მიღება →

2Authentication

ყველა მოთხოვნა უნდა შეიცავდეს Authorization header-ს Bearer ტოკენით.

Request Header
Authorization: Bearer gc_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxx
Content-Type: application/json

3Endpoints

POST/api/v1/transcribe

ვიდეოს ატვირთვა და სუბტიტრის გენერაციის job-ის შექმნა. ბრუნდება job ID რომლითაც შეგიძლიათ სტატუსის შემოწმება.

Request (multipart/form-data)
curl -X POST https://geocaption.ge/api/v1/transcribe \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@video.mp4" \
  -F "language=ka" \
  -F "format=srt"
Response 200
{
  "job_id": "job_a1b2c3d4e5f6",
  "status": "queued",
  "created_at": "2026-06-14T10:00:00Z",
  "estimated_seconds": 45
}

პარამეტრები

fileFile*ვიდეო ფაილი (MP4, MOV, AVI, MKV). მაქს. 500MB.
languagestringენის კოდი. default: "ka" (ქართული).
formatstringგამოტანის ფორმატი: srt, vtt, ass, txt. default: srt.
GET/api/v1/jobs/{id}

Job-ის სტატუსის შემოწმება. Polling-ით შეამოწმეთ სანამ სტატუსი completed-ი არ გახდება.

Request
curl https://geocaption.ge/api/v1/jobs/job_a1b2c3d4e5f6 \
  -H "Authorization: Bearer YOUR_API_KEY"
Response 200
{
  "job_id": "job_a1b2c3d4e5f6",
  "status": "completed",
  "progress": 100,
  "duration_seconds": 38,
  "created_at": "2026-06-14T10:00:00Z",
  "completed_at": "2026-06-14T10:00:38Z"
}

სტატუსის მნიშვნელობები

queuedprocessingcompletedfailed
GET/api/v1/jobs/{id}/subtitles

სუბტიტრის ჩამოტვირთვა. მხოლოდ completed status-ის შემდეგ.

Request
curl https://geocaption.ge/api/v1/jobs/job_a1b2c3d4e5f6/subtitles \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -o subtitles.srt
Response 200 (SRT)
1
00:00:00,000 --> 00:00:03,500
გამარჯობა, ეს არის ტესტ ვიდეო.

2
00:00:03,500 --> 00:00:07,200
ქართული AI სუბტიტრები მზადაა.

4Rate Limits

გეგმამოთხოვნები/წთConcurrent Jobsმაქს. ფაილი
Pro603200 MB
Enterprise60020500 MB

Limit-ის გადაჭარბებისას HTTP 429 კოდი დაბრუნდება. Enterprise გეგმაზე გადასასვლელად დაგვიკავშირდით.

მზად ხართ დასაწყებად?

მიიღეთ API გასაღები პროფილის გვერდზე — Pro გეგმა საჭიროა.

API გასაღები →Enterprise გეგმა