مستندات و مرجع کامل API سابیار

curl -X GET "https://subyar.com/api/providers/" \
  -H "X-API-Key: sub_live_your_api_key_here"

{
  "providers": [
    {
      "id": "gemini",
      "name": "Google Gemini",
      "supports_model_selection": true,
      "models": [
        {
          "id": "gemini-2.5-flash",
          "name": "Gemini 2.5 Flash (پر سرعت و بهینه)"
        },
        {
          "id": "gemini-2.5-pro",
          "name": "Gemini 2.5 Pro (بالاترین کیفیت ادبی)"
        }
      ]
    },
    {
      "id": "openrouter",
      "name": "OpenRouter",
      "supports_model_selection": true,
      "models": [
        {
          "id": "anthropic/claude-3.5-sonnet",
          "name": "Claude 3.5 Sonnet"
        },
        {
          "id": "openai/gpt-4o",
          "name": "GPT-4o"
        },
        {
          "id": "meta-llama/llama-3.3-70b-instruct",
          "name": "Llama 3.3 70B"
        }
      ]
    }
  ]
}

curl -X GET "https://subyar.com/api/providers/default-selection" \
  -H "X-API-Key: sub_live_your_api_key_here"

{
  "selection": {
    "provider_id": "gemini",
    "model_id": "gemini-2.5-flash"
  }
}

curl -X GET "https://subyar.com/api/templates/" \
  -H "X-API-Key: sub_live_your_api_key_here"

{
  "templates": [
    {
      "id": "b45a0b7c-1234-4567-8901-abcdef123456",
      "name_en": "Anime & Animation (Casual)",
      "name_fa": "انیمه و انیمیشن (لحن محاوره‌ای جوانانه)",
      "is_builtin": true,
      "description_fa": "مناسب دیالوگ‌های پرهیجان، حفظ اصطلاحات ژاپنی و نگارش روان",
      "values": {
        "content.source_lang": "en",
        "content.target_lang": "fa",
        "tone": "casual",
        "system_prompt": "Translate subtitles naturally for anime fans..."
      },
      "created_at": "2026-01-01T00:00:00Z"
    },
    {
      "id": "c98e1f2a-5678-4321-9876-fedcba654321",
      "name_en": "Documentary (Formal)",
      "name_fa": "مستند و فیلم تاریخی (لحن رسمی و فاخر)",
      "is_builtin": true,
      "description_fa": "واژه‌گزینی دقیق و ادبی برای مستندهای علمی و تاریخی",
      "values": {
        "content.source_lang": "en",
        "content.target_lang": "fa",
        "tone": "formal"
      },
      "created_at": "2026-01-01T00:00:00Z"
    }
  ]
}

curl -X POST "https://subyar.com/api/templates/" \
  -H "X-API-Key: sub_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "name_fa": "سریال‌های سیتکام طنز",
    "name_en": "Comedy Sitcoms",
    "description_fa": "حفظ شوخی‌ها و اصطلاحات طنز",
    "values": { "tone": "humorous" }
  }'

{
  "id": "d12e3456-789a-bcde-f012-3456789abcde",
  "name_fa": "سریال‌های سیتکام طنز",
  "name_en": "Comedy Sitcoms",
  "is_builtin": false,
  "values": {
    "tone": "humorous"
  },
  "created_at": "2026-09-13T09:00:00Z"
}

curl -X POST "https://subyar.com/api/jobs/" \
  -H "X-API-Key: sub_live_your_api_key_here" \
  -F "file=@episode_01.srt" \
  -F "ai_provider=gemini" \
  -F 'job_options={"model": "gemini-2.5-flash", "template_id": "b45a0b7c-..."}' \
  -F 'content_spec={"conversation_settings": {"source_language": "en", "target_language": "fa"}}'

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "source_filename": "episode_01.srt",
  "status": "pending",
  "total_lines": 480,
  "translated_lines": 0,
  "progress_percentage": 0,
  "ai_provider": "gemini",
  "created_at": "2026-09-13T09:10:00Z"
}

curl -X POST "https://subyar.com/api/jobs/estimate" \
  -H "X-API-Key: sub_live_your_api_key_here" \
  -F "file=@episode_01.srt"

{
  "total_lines": 480,
  "total_words": 3410,
  "estimated_tokens": 4950,
  "can_afford": true,
  "user_words_remaining": 50000
}

curl -X GET "https://subyar.com/api/jobs/550e8400-e29b-41d4-a716-446655440000" \
  -H "X-API-Key: sub_live_your_api_key_here"

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "translating",
  "progress_percentage": 65,
  "total_lines": 480,
  "translated_lines": 312,
  "source_filename": "episode_01.srt",
  "created_at": "2026-09-13T09:10:00Z",
  "completed_at": null
}

curl -X GET "https://subyar.com/api/jobs/550e8400-e29b-41d4-a716-446655440000/preview" \
  -H "X-API-Key: sub_live_your_api_key_here"

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "total_events": 480,
  "events": [
    {
      "index": 1,
      "start": "00:00:01.50",
      "end": "00:00:04.20",
      "original": "Welcome to Subyar AI platform!",
      "translated": "به پلتفرم هوش مصنوعی سابیار خوش آمدید!"
    }
  ]
}

curl -O -J "https://subyar.com/api/jobs/550e8400-e29b-41d4-a716-446655440000/download?format=srt" \
  -H "X-API-Key: sub_live_your_api_key_here"

1
00:00:01,500 --> 00:00:04,200
به پلتفرم هوش مصنوعی سابیار خوش آمدید!

2
...

curl -X GET "https://subyar.com/api/conversations/" \
  -H "X-API-Key: sub_live_your_api_key_here"

[
  {
    "id": "conv_123456",
    "title": "ترجمه سریال فرندز - فصل ۱",
    "message_count": 8,
    "settings": {
      "provider": "gemini",
      "model": "gemini-2.5-flash"
    },
    "created_at": "2026-09-13T07:30:00Z"
  }
]

curl -X POST "https://subyar.com/api/conversations/" \
  -H "X-API-Key: sub_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"title": "ترجمه انیمه اتک آن تایتان"}'

{
  "id": "conv_abcdef",
  "title": "ترجمه انیمه اتک آن تایتان",
  "message_count": 0,
  "settings": {},
  "created_at": "2026-09-13T09:15:00Z"
}

curl -X POST "https://subyar.com/api/conversations/conv_abcdef/messages" \
  -H "X-API-Key: sub_live_your_api_key_here" \
  -F "content=لطفاً تیکه‌کلام‌ها را عامیانه‌تر ترجمه کن" \
  -F "model_id=gemini-2.5-flash"

[
  {
    "id": "msg_user_1",
    "role": "user",
    "content": "لطفاً تیکه‌کلام‌ها را عامیانه‌تر ترجمه کن",
    "created_at": "2026-09-13T09:16:00Z"
  },
  {
    "id": "msg_ai_2",
    "role": "assistant",
    "content": "ویرایش هوشمند با موفقیت روی خطوط مورد نظر اعمال شد.",
    "file": {
      "type": "copilot_edit",
      "status": "completed",
      "summary": "لحن خطوط عامیانه و روان گردید."
    },
    "created_at": "2026-09-13T09:16:02Z"
  }
]

curl -X POST "https://subyar.com/api/tools/rtl-fix" \
  -H "X-API-Key: sub_live_your_api_key_here" \
  -F "file=@unfixed.srt" \
  --output "fixed.srt"

[Fixed subtitle file binary stream]

curl -X POST "https://subyar.com/api/tools/srt-to-ass" \
  -H "X-API-Key: sub_live_your_api_key_here" \
  -F "srt_file=@input.srt" \
  -F "tone=anime"

{
  "job_id": "srt2ass-98124-abc",
  "status": "processing",
  "message": "Conversion job dispatched"
}

curl -X POST "https://subyar.com/api/api-keys/" \
  -H "Authorization: Bearer <YOUR_JWT_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"name": "My Translation Bot", "expires_in_days": 90}'

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "name": "My Translation Bot",
  "key_prefix": "sub_live_a1b2c3...",
  "scopes": [
    "*"
  ],
  "is_active": true,
  "expires_at": "2026-12-12T08:00:00Z",
  "created_at": "2026-09-13T09:00:00Z",
  "secret_key": "sub_live_a1b2c3d4e5f678901234567890abcdef"
}

curl -X GET "https://subyar.com/api/api-keys/" \
  -H "Authorization: Bearer <YOUR_JWT_TOKEN>"

{
  "keys": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "name": "My Translation Bot",
      "key_prefix": "sub_live_a1b2c3...",
      "scopes": [
        "*"
      ],
      "is_active": true,
      "last_used_at": "2026-09-13T09:12:00Z",
      "expires_at": null,
      "created_at": "2026-09-13T09:00:00Z"
    }
  ],
  "total": 1
}

curl -X DELETE "https://subyar.com/api/api-keys/3fa85f64-5717-4562-b3fc-2c963f66afa6" \
  -H "Authorization: Bearer <YOUR_JWT_TOKEN>"

{
  "status": "ok",
  "deleted": true,
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}

curl -X GET "https://subyar.com/api/users/profile" \
  -H "X-API-Key: sub_live_your_api_key_here"

{
  "id": "usr_123456",
  "email": "developer@example.com",
  "username": "subyar_dev",
  "is_active": true,
  "is_premium": true,
  "phone_verified": true,
  "created_at": "2026-01-01T00:00:00Z"
}

curl -X GET "https://subyar.com/api/plans/entitlements" \
  -H "X-API-Key: sub_live_your_api_key_here"

{
  "plan_name": "Pro Monthly",
  "words_limit": 150000,
  "words_used": 42000,
  "words_remaining": 108000,
  "expires_at": "2026-10-15T00:00:00Z",
  "is_active": true
}