Felo API PlatformFelo API Platform

গাইড

ফাইল আপলোড

ফাইল একবার আপলোড করুন, তারপর Messages, Responses, ছবি তৈরি ও ভিডিও তৈরির অনুরোধে ID দিয়ে রেফারেন্স করুন।

একটি ফাইল একবার আপলোড করুন, তারপর মডেল অনুরোধে সেটিকে ID দিয়ে রেফারেন্স করুন। এটি একই বাইট base64 হিসেবে আবার পাঠানো বা ফাইলটি কোনো পাবলিক URL-এ হোস্ট করার বিকল্প।

ফাইল ID Messages, Responses, ইমেজ জেনারেশন ও ভিডিও জেনারেশনের সাথে কাজ করে। এটি Chat Completions-এর সাথে কাজ করে না।

শুরু করার আগে

দ্রুত শুরু

1. ফাইল আপলোড করুন

curl "https://openapi.felo.ai/api/v1/files" \
  -H "Authorization: Bearer ${FELO_API_KEY}" \
  -F "file=@./report.pdf"

সফল আপলোড ফাইলের মেটাডেটাসহ HTTP 200 ফেরত দেয়:

{
  "id": "felo_file_0179...",
  "type": "file",
  "source": "upload",
  "filename": "report.pdf",
  "mime_type": "application/pdf",
  "size_bytes": 482113,
  "created_at": "2026-11-10T02:25:41Z",
  "downloadable": false
}

id সংরক্ষণ করুন। এটিকে একটি opaque স্ট্রিং হিসেবে ধরুন: নিজে এটি তৈরি বা পার্স করবেন না।

2. অনুরোধে ফাইলটি রেফারেন্স করুন

curl "https://openapi.felo.ai/api/v1/responses" \
  -H "Authorization: Bearer ${FELO_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "input": [
      {
        "role": "user",
        "content": [
          {"type": "input_file", "file_id": "felo_file_0179..."},
          {"type": "input_text", "text": "Summarize the attached report."}
        ]
      }
    ]
  }'

একই দুটি ধাপ Python-এ:

import os

import requests

BASE = "https://openapi.felo.ai"
HEADERS = {"Authorization": f"Bearer {os.environ['FELO_API_KEY']}"}


def upload(path: str) -> str:
    with open(path, "rb") as file:
        response = requests.post(
            f"{BASE}/api/v1/files",
            headers=HEADERS,
            files={"file": file},
            timeout=300,
        )
    response.raise_for_status()
    return response.json()["id"]


file_id = upload("./report.pdf")

response = requests.post(
    f"{BASE}/api/v1/responses",
    headers=HEADERS,
    json={
        "model": "gpt-5.5",
        "input": [
            {
                "role": "user",
                "content": [
                    {"type": "input_file", "file_id": file_id},
                    {"type": "input_text", "text": "Summarize the attached report."},
                ],
            }
        ],
    },
    timeout=120,
)
response.raise_for_status()
print(response.json())

এবং Node.js 20 বা তার পরের সংস্করণে:

import { openAsBlob } from "node:fs";
import { basename } from "node:path";

const BASE = "https://openapi.felo.ai";
const headers = { Authorization: `Bearer ${process.env.FELO_API_KEY}` };

async function upload(path) {
  const form = new FormData();
  form.append("file", await openAsBlob(path), basename(path));
  const response = await fetch(`${BASE}/api/v1/files`, { method: "POST", headers, body: form });
  if (!response.ok) throw new Error(`Upload failed: ${response.status} ${await response.text()}`);
  return (await response.json()).id;
}

const fileId = await upload("./report.pdf");

আপলোডের নিয়ম

  • body হলো multipart/form-data, যাতে ঠিক একটি পার্ট থাকে, যার নাম file। purpose সহ অন্য যেকোনো পার্ট invalid_file দিয়ে প্রত্যাখ্যাত হয়।
  • আপনার HTTP ক্লায়েন্টকে Content-Type সেট করতে দিন। হাতে সেট করলে multipart boundary বাদ পড়ে যায়।
  • আপলোড URL-এ query প্যারামিটার যোগ করবেন না।
  • SDK-র Files helper-এর বদলে HTTP দিয়ে আপলোড করুন। OpenAI SDK-র files.create() সবসময় purpose পাঠায়, তাই এটি এই endpoint কল করতে পারে না।
  • যে আপলোড টাইমআউট হয় বা যার সংযোগ বিচ্ছিন্ন হয়, সেটি তবুও সংরক্ষিত হয়ে থাকতে পারে। আবার আপলোড করার আগে আপনার ফাইলগুলোর তালিকা দেখুন।

ফাইল ID কোথায় ব্যবহার করা যায়

Endpointফাইলের ধরনপ্রয়োজনীয় input মোডালিটিফিল্ড
POST /api/v1/messagesPDF, ইমেজfile, imagemessages[].content[]
POST /api/v1/responsesPDF, ইমেজfile, imageinput[].content[]
POST /api/v1/images/generationsইমেজimageinput_references[]
POST /api/v1/videos/generationsইমেজimageframe_images[]
POST /api/v1/videos/generationsইমেজ, MP4, অডিওimage, video, audioinput_references[]
POST /api/v1/chat/completionsসমর্থিত নয়

Messages

{
  "model": "claude-haiku-4-5",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": [
        {"type": "document", "source": {"type": "file", "file_id": "felo_file_0179..."}},
        {"type": "text", "text": "Summarize the attached report."}
      ]
    }
  ]
}

ইমেজের জন্য {"type": "image", "source": {"type": "file", "file_id": "..."}} ব্যবহার করুন।

Responses

ফাইলকনটেন্ট ব্লক
PDF{"type": "input_file", "file_id": "..."}
ইমেজ{"type": "input_image", "file_id": "...", "detail": "auto"}

যে ব্লকে file_id থাকে, তাতে একই সাথে URL বা base64 ডেটা থাকা চলবে না।

ইমেজ জেনারেশন

{
  "model": "gemini-3-pro-image",
  "prompt": "Keep the product and framing. Replace the background with a sunlit marble countertop.",
  "input_references": [
    {"type": "image_url", "image_url": {"file_id": "felo_file_0179..."}}
  ]
}

অনুরোধের বাকি অংশ, 202 রেসপন্স এবং পোলিং ইমেজ জেনারেশন-এ বর্ণিত।

ভিডিও জেনারেশন

প্রথম ও শেষ ফ্রেম frame_images-এ যায়:

{
  "model": "YOUR_VIDEO_MODEL",
  "prompt": "The camera slowly pushes in. Keep the colors and composition.",
  "duration": 5,
  "resolution": "720p",
  "frame_images": [
    {
      "type": "image_url",
      "frame_type": "first_frame",
      "image_url": {"file_id": "felo_file_0179..."}
    }
  ]
}

শেষ ফ্রেমের জন্য "frame_type": "last_frame" দিয়ে দ্বিতীয় একটি এন্ট্রি যোগ করুন। শেষ ফ্রেমের জন্য প্রথম ফ্রেম আবশ্যক।

reference উপাদান input_references-এ যায়। প্রতিটি এন্ট্রি তার মিডিয়ার ধরনের সাথে মেলে এমন locator ব্যবহার করে:

{
  "input_references": [
    {"type": "image_url", "image_url": {"file_id": "felo_file_IMAGE"}},
    {"type": "video_url", "video_url": {"file_id": "felo_file_VIDEO"}},
    {"type": "audio_url", "audio_url": {"file_id": "felo_file_AUDIO"}}
  ]
}

একটি মডেল কোন কোন সমন্বয় গ্রহণ করে তা মডেল ও চ্যানেলের উপর নির্ভর করে। frame_images ও input_references একই অনুরোধে ব্যবহার করা যায় না।

Locator-এর নিয়ম

  • ইমেজ ও ভিডিও অনুরোধে প্রতিটি image_url, video_url বা audio_url অবজেক্টে file_id বা url-এর মধ্যে ঠিক একটি থাকে, এবং অন্য কোনো ফিল্ড থাকে না।
  • একটি অ্যারেতে file_id ব্যবহার করা এন্ট্রি ও url ব্যবহার করা এন্ট্রি একসাথে থাকতে পারে।
  • ইমেজ ও ভিডিও জেনারেশন শুধু আপনার আপলোড করা ফাইল গ্রহণ করে। জেনারেট করা ইমেজ আবার ব্যবহার করতে তার output url পাঠান।
  • ফাইল রেফারেন্স করা অনুরোধ ব্যর্থ হলে অন্য চ্যানেলে সরানো হয় না। ত্রুটি না দেখে এটিকে অন্য চ্যানেলে রিট্রাই করবেন না।
  • একটি ফাইল রেফারেন্স করা প্রতিটি টাস্ক টার্মিনাল অবস্থায় না পৌঁছানো পর্যন্ত ফাইলটি রেখে দিন। আগে মুছে ফেললে টাস্ক ব্যর্থ হতে পারে।

মডেল সাপোর্ট যাচাই করুন

সংরক্ষিত ফাইল স্বয়ংক্রিয়ভাবে সব মডেলের সাথে ব্যবহারযোগ্য হয় না। মডেলকে পাবলিক ক্যাটালগে সংশ্লিষ্ট input মোডালিটি ঘোষণা করতে হয়:

curl -s "https://openapi.felo.ai/api/platform/model-catalog/model?model=claude-haiku-4-5" \
  | jq '.data.input_modalities'
["text", "image", "file"]
যা পাঠাবেনinput_modalities-এ যা থাকতে হবে
PDFfile
ইমেজimage
MP4video
অডিও ফাইলaudio

তালিকা খালি বা অনুপস্থিত থাকলে বুঝতে হবে ওই মডেলের জন্য ফাইল ID চালু নেই। তখন অনুরোধ file_model_unsupported দিয়ে ব্যর্থ হয়। মডেলের নাম দেখে সাপোর্ট অনুমান করবেন না।

সীমা

সীমামান
আপলোডের আকারপ্রতি ফাইলে 100 MiB (104,857,600 বাইট); খালি ফাইল প্রত্যাখ্যাত হয়
প্রতি মডেল অনুরোধে রেফারেন্স করা বাইটমোট 50,000,000 বাইট
প্রতি মডেল অনুরোধে reference100
ফাইলনামের দৈর্ঘ্য255 অক্ষর

একই ফাইল দুবার রেফারেন্স করলে তা অনুরোধের উভয় সীমাতেই দুবার গণনা হয়। 50 MB থেকে 100 MiB-এর মধ্যে থাকা ফাইল আপলোড করা যায়, কিন্তু মডেল অনুরোধে রেফারেন্স করা যায় না। কোনো মডেল বা চ্যানেল আরও কম সীমা প্রয়োগ করতে পারে।

ফাইলের ধরন

ধরন ফাইলের কনটেন্ট থেকে শনাক্ত করা হয়, এক্সটেনশন বা পার্টের Content-Type থেকে নয়।

ধরনফরম্যাটযেখানে রেফারেন্স করা যায়
PDFPDFMessages, Responses
ইমেজPNG, JPEG, GIF, WebPMessages, Responses, ইমেজ জেনারেশন, ভিডিও জেনারেশন
ভিডিওMP4ভিডিও জেনারেশন
অডিওMP3, WAV, FLAC, OGGভিডিও জেনারেশন
OfficeDOCX, XLSX, PPTXশুধু স্টোরেজ
টেক্সটUTF-8 টেক্সট, text/plain হিসেবে সংরক্ষিতশুধু স্টোরেজ

অন্য যেকোনো কনটেন্ট invalid_file দিয়ে প্রত্যাখ্যাত হয়।

ফাইলনাম

ফাইলনামে <, >, :, ", |, ?, *, \ বা কন্ট্রোল ক্যারেক্টার থাকতে পারবে না। / বিভাজক হিসেবে অনুমোদিত, কিন্তু খালি সেগমেন্ট, . এবং .. অনুমোদিত নয়।

ফাইল পরিচালনা করুন

ফাইলগুলো আপনার অ্যাকাউন্টের। অ্যাকাউন্টের প্রতিটি API key একই ফাইল দেখে; অন্য অ্যাকাউন্ট আপনার ফাইল ID ব্যবহার করতে পারে না।

ফাইলের তালিকা দেখুন

curl "https://openapi.felo.ai/api/v1/files?limit=100" \
  -H "Authorization: Bearer ${FELO_API_KEY}"
{
  "data": [
    {
      "id": "felo_file_0179...",
      "type": "file",
      "source": "upload",
      "filename": "report.pdf",
      "mime_type": "application/pdf",
      "size_bytes": 482113,
      "created_at": "2026-11-10T02:25:41Z",
      "downloadable": false
    }
  ],
  "first_id": "felo_file_0179...",
  "last_id": "felo_file_0179...",
  "cursor": "felo_file_0179...",
  "has_more": false
}

ফলাফল সবচেয়ে পুরোনো থেকে শুরু করে সাজানো থাকে। has_more যখন true, পরের পেজ পেতে ফেরত আসা cursor পাঠান। সার্ভার-সাইডে কোনো সার্চ বা ধরন অনুযায়ী ফিল্টার নেই।

একটি ফাইল আনুন

curl "https://openapi.felo.ai/api/v1/files/${FILE_ID}" \
  -H "Authorization: Bearer ${FELO_API_KEY}"

ফাইল মুছুন

curl -X DELETE "https://openapi.felo.ai/api/v1/files/${FILE_ID}" \
  -H "Authorization: Bearer ${FELO_API_KEY}"
{"id": "felo_file_0179...", "type": "file_deleted"}

মুছে ফেলা সাথে সাথে কার্যকর হয় এবং তা ফেরানো যায় না। 503 মানে মুছে ফেলা সম্পূর্ণ হয়নি; DELETE আবার পাঠান।

ডাউনলোড

আপলোড করা ফাইল ডাউনলোড করা যায় না। GET /api/v1/files/{file_id}/content 400 file_not_downloadable ফেরত দেয়, এবং আপলোড রেসপন্সের Location header ফাইলের মেটাডেটার দিকে নির্দেশ করে, তার বাইটের দিকে নয়। আপনি যা-ই আপলোড করুন, তার নিজস্ব একটি কপি রাখুন।

জেনারেট করা মিডিয়া ডাউনলোড করতে টাস্কের outputs-এ থাকা স্বাক্ষরিত URL ব্যবহার করুন।

API রেফারেন্স

সব endpoint Authorization: Bearer YOUR_API_KEY ব্যবহার করে। সফল রেসপন্স কোনো envelope ছাড়া সাধারণ JSON অবজেক্ট।

মেথডPathযা ফেরত দেয়
POST/api/v1/filesফাইল অবজেক্ট
GET/api/v1/filesফাইলের একটি পেজ
GET/api/v1/files/{file_id}ফাইল অবজেক্ট
DELETE/api/v1/files/{file_id}{"id": "...", "type": "file_deleted"}
GET/api/v1/files/{file_id}/content400 file_not_downloadable

POST, DELETE এবং একক-ফাইলের GET যেকোনো query প্যারামিটার invalid_query দিয়ে প্রত্যাখ্যান করে।

ফাইল অবজেক্ট

ফিল্ডটাইপবর্ণনা
idstringফাইল ID, যার প্রিফিক্স felo_file_। এটি file_id হিসেবে ব্যবহার করুন
typestringসবসময় file
sourcestringআপনার আপলোড করা ফাইলের জন্য upload, মডেল output-এর জন্য generated
filenamestringআপলোডের সাথে পাঠানো নাম
mime_typestringকনটেন্ট থেকে শনাক্ত করা ধরন
size_bytesintegerবাইটে আকার
created_atstringISO 8601 UTC টাইমস্ট্যাম্প
downloadablebooleanআপলোড করা ফাইলের জন্য false

আপলোড অনুরোধ

পার্টআবশ্যকবর্ণনা
fileহ্যাঁফাইলটি, যা ফাইলনামসহ একটি multipart/form-data ফাইল পার্ট হিসেবে পাঠানো হয়

রেসপন্সে একটি Location header থাকে, যাতে ফাইলের মেটাডেটার URL থাকে।

তালিকার প্যারামিটার

প্যারামিটারডিফল্টবর্ণনা
limit100পেজের আকার, 1 থেকে 1000
cursorআগের পেজ থেকে পাওয়া cursor মান
after, after_idcursor-এর বিকল্প নাম। তিনটির মধ্যে শুধু একটি পাঠান
orderascশুধু asc সমর্থিত
রেসপন্স ফিল্ডটাইপবর্ণনা
dataarrayফাইল অবজেক্ট, সবচেয়ে পুরোনো আগে
first_idstring বা nullপেজের প্রথম ফাইলের ID
last_idstring বা nullপেজের শেষ ফাইলের ID
cursorstring বা nullপরের পেজের জন্য cursor হিসেবে পাঠানোর মান
has_morebooleanআরেকটি পেজ আছে কি না

ত্রুটি

Files endpoint, Responses এবং ইমেজ ও ভিডিও জেনারেশন OpenAI error envelope ব্যবহার করে:

{
  "error": {
    "message": "This model does not accept this attachment type",
    "type": "invalid_request_error",
    "param": "frame_images.0.image_url",
    "code": "file_model_unsupported"
  }
}

Files endpoint-এর ত্রুটির ক্ষেত্রে param হলো null। Messages Anthropic-এর error shape ফেরত দেয়, যাতে error.code নেই। request ID X-Request-Id রেসপন্স header-এ থাকে।

ফাইল আপলোড বা পরিচালনার সময়ের ত্রুটি:

HTTPerror.codeঅর্থ
400invalid_content_typebody multipart/form-data নয়
400invalid_filefile পার্ট নেই, অতিরিক্ত পার্ট আছে, ফাইল খালি, বা কনটেন্ট সমর্থিত নয়
400invalid_filenameফাইলনাম খুব লম্বা বা তাতে প্রত্যাখ্যাত অক্ষর আছে
413file_too_largeফাইল 100 MiB ছাড়িয়েছে
400invalid_queryঅসমর্থিত query প্যারামিটার, বা order-এর মান asc ছাড়া অন্য কিছু
400invalid_limitlimit 1 থেকে 1000-এর বাইরে
400invalid_cursorcursor-এর ফরম্যাট ভুল, বা একাধিক cursor পাঠানো হয়েছে
400file_not_downloadable/content অনুরোধ করা হয়েছে
404file_not_foundফাইলটি নেই, মুছে ফেলা হয়েছে, বা অন্য অ্যাকাউন্টের
503file_storage_unavailableফাইল স্টোরেজ সাময়িকভাবে অনুপলব্ধ; পরে রিট্রাই করুন
503file_upload_expiredআপলোড সময়মতো সম্পূর্ণ হয়নি; ফাইলটি আবার আপলোড করুন

মডেল অনুরোধে ফাইল রেফারেন্স করার সময়ের ত্রুটি:

HTTPerror.codeঅর্থ
400invalid_file_inputID-র ফরম্যাট ভুল, একটি locator-এ file_id ও url দুটোই আছে, বা 100টির বেশি reference
400unsupported_file_typeফাইলের ধরন অবস্থানের সাথে মেলে না, যেমন ডকুমেন্ট ব্লকে MP4
400file_model_unsupportedমডেল প্রয়োজনীয় input মোডালিটি ঘোষণা করে না
400file_input_too_largeরেফারেন্স করা ফাইলগুলো মোট 50,000,000 বাইট ছাড়িয়েছে
400file_protocol_unsupportedChat Completions-এ একটি ফাইল ID পাঠানো হয়েছে
404file_not_foundফাইলটি নেই, মুছে ফেলা হয়েছে, অন্য অ্যাকাউন্টের, বা এটি ইমেজ বা ভিডিও জেনারেশনে পাঠানো একটি জেনারেট করা ফাইল

ইমেজ ও ভিডিও জেনারেশনে ফাইল 202-এর পরেও ব্যর্থ হতে পারে। তখন টাস্ক failed হিসেবে শেষ হয় এবং error.code-এ এই কোডগুলোর একটি থাকে।

প্রমাণীকরণ, ব্যালেন্স ও রেট সীমার ত্রুটি ত্রুটি, সীমা ও রিট্রাই-এ বর্ণিত।

সম্পর্কিত

সাহায্য দরকার?