Files API

/v1/files endpoint’i büyük görseller, ses dosyaları, PDF ve birden fazla istekte kullanılacak reusable medya için kullanılır.

Yükleme

curl https://llmtr.com/v1/files \
  -H "Authorization: Bearer llmtr-your_key" \
  -F "provider=google" \
  -F "purpose=user_upload" \
  -F "file=@./invoice.pdf"

`purpose` değerleri

Değer	Ne zaman?
`user_upload`	Genel amaçlı yükleme. Chat içinde `input_file.file_id` ile gönderilen PDF, görsel veya ses dosyaları.
`vision_reference`	`/v1/images/generations` üzerinde `file_id` / `file_ids` ile gönderilecek referans görsel. Try-on, image-to-image ve iki görseli birleştirme akışları bu purpose’u kullanır.

Belirtilmezse varsayılan user_upload’tır. Bu iki değer dışında bir purpose gönderilirse 400 invalid_request döner.

`provider` değerleri

Şu anda yalnızca google desteklenir. Belirtilmezse varsayılan google’dur; farklı bir provider gönderilirse 400 unsupported_provider döner.

Yanıt:

{
  "id": "file_xxx",
  "object": "file",
  "provider": "google",
  "purpose": "user_upload",
  "filename": "invoice.pdf",
  "bytes": 184732,
  "mime_type": "application/pdf",
  "created_at": 1739200000
}

İstekte kullanma

Dönen file_id değerini herhangi bir content-part türünde referans olarak kullanın:

{
  "model": "google/gemini-2.5-flash",
  "messages": [
    {
      "role": "user",
      "content": [
        { "type": "text", "text": "Bu PDF'i özetle." },
        {
          "type": "input_file",
          "input_file": {
            "file_id": "file_xxx",
            "mime_type": "application/pdf"
          }
        }
      ]
    }
  ]
}

Desteklenen MIME türleri

Kategori	Türler
Görsel	`image/jpeg`, `image/png`, `image/webp`, `image/heic`
Ses	`audio/wav`, `audio/mp3`, `audio/flac`, `audio/ogg`, `audio/webm`
Video	`video/mp4`, `video/webm`, `video/quicktime`
Belge	`application/pdf`

Sınırlar

Tek dosya maksimum 20 MB (sağlayıcı bazında değişebilir)
Yüklenen dosyalar yükleme tarihinden 7 gün sonra otomatik silinir
Aynı file_id farklı modellerde kullanılabilir, provider aynı olmak kaydıyla

Saklama

Yüklediğiniz dosyalar LLMTR tarafından yönetilir; sizden yalnızca canonical file_id görünür. İsteklerinizde bu kimliği input_file.file_id, /v1/images/generations içindeki file_id veya file_ids alanlarında doğrudan kullanabilirsiniz.