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 sk_your_key" \
  -F "provider=google" \
  -F "purpose=user_upload" \
  -F "file=@./invoice.pdf"

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)
• TTL 48 saat (provider’a göre)
• Aynı file_id farklı modellerde kullanılabilir, provider aynı olmak kaydıyla

Provider bazında

Her provider kendi dosya yönetimine sahiptir. Google’ın generativelanguage.googleapis.com/v1beta/files altyapısı backend tarafında saklanır; sizden sadece canonical file_id görünür.