Gemini API প্রম্পট ইনপুট থেকে আলাদাভাবে মিডিয়া ফাইল আপলোড করা সমর্থন করে, আপনার মিডিয়াকে একাধিক অনুরোধ এবং একাধিক প্রম্পট জুড়ে পুনরায় ব্যবহার করার অনুমতি দেয়। আরো বিস্তারিত জানার জন্য, মিডিয়া গাইডের সাথে প্রম্পটিং দেখুন।
পদ্ধতি: media.upload
একটি File
তৈরি করে।
শেষবিন্দু
শরীরের অনুরোধ
অনুরোধের অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:
file
object ( File
)
ঐচ্ছিক। ফাইল তৈরি করার জন্য মেটাডেটা।
উদাহরণ অনুরোধ
ছবি
পাইথন
Node.js
যাও
শেল
অডিও
পাইথন
Node.js
যাও
শেল
পাঠ্য
পাইথন
Node.js
যাও
শেল
ভিডিও
পাইথন
Node.js
যাও
শেল
পাইথন
পদ্ধতি: files.get
প্রদত্ত File
জন্য মেটাডেটা পায়।
শেষবিন্দু
https://generativelanguage.googleapis.com/v1beta/{name=files/*} পানপাথ প্যারামিটার
name
string
প্রয়োজন। File
নাম পেতে হবে। উদাহরণ: files/abc-123
এটি files/{file}
ফর্ম নেয়।
শরীরের অনুরোধ
অনুরোধের বডি খালি হতে হবে।
উদাহরণ অনুরোধ
পাইথন
Node.js
যাও
শেল
প্রতিক্রিয়া শরীর
সফল হলে, প্রতিক্রিয়া বডিতে File
একটি উদাহরণ থাকে।
পদ্ধতি: files.list
অনুরোধ করা প্রকল্পের মালিকানাধীন File
মেটাডেটা তালিকাভুক্ত করে।
শেষবিন্দু
https://generativelanguage.googleapis.com/v1beta/files পানক্যোয়ারী প্যারামিটার
pageSize
integer
ঐচ্ছিক। প্রতি পৃষ্ঠায় ফেরত দেওয়ার জন্য সর্বাধিক সংখ্যক File
৷ অনির্দিষ্ট থাকলে, ডিফল্ট 10। সর্বোচ্চ pageSize
হল 100।
pageToken
string
ঐচ্ছিক। পূর্ববর্তী files.list
কল থেকে একটি পৃষ্ঠা টোকেন।
শরীরের অনুরোধ
অনুরোধের বডি খালি হতে হবে।
উদাহরণ অনুরোধ
পাইথন
Node.js
যাও
শেল
প্রতিক্রিয়া শরীর
files.list
এর জন্য প্রতিক্রিয়া।
সফল হলে, প্রতিক্রিয়া বডিতে নিম্নলিখিত কাঠামোর সাথে ডেটা থাকে:
files[]
object ( File
)
File
তালিকা s.
nextPageToken
string
একটি টোকেন যা একটি পরবর্তী files.list
কলে একটি pageToken
হিসাবে পাঠানো যেতে পারে।
JSON প্রতিনিধিত্ব |
---|
{
"files": [
{
object ( |
পদ্ধতি: files.delete
File
মুছে দেয়।
শেষবিন্দু
https://generativelanguage.googleapis.com/v1beta/{name=files/*} মুছুনপাথ প্যারামিটার
name
string
প্রয়োজন। মুছে ফেলার জন্য File
নাম। উদাহরণ: files/abc-123
এটি files/{file}
ফর্ম নেয়।
শরীরের অনুরোধ
অনুরোধের বডি খালি হতে হবে।
উদাহরণ অনুরোধ
পাইথন
Node.js
যাও
শেল
প্রতিক্রিয়া শরীর
সফল হলে, প্রতিক্রিয়া বডি খালি।
REST সম্পদ: ফাইল
সম্পদ: ফাইল
API এ আপলোড করা একটি ফাইল।
name
string
অপরিবর্তনীয়। শনাক্তকারী। File
রিসোর্সের নাম। আইডি ("ফাইল/" উপসর্গ ব্যতীত নাম) 40টি পর্যন্ত অক্ষর থাকতে পারে যা ছোট হাতের বর্ণমালা বা ড্যাশ (-)। আইডি ড্যাশ দিয়ে শুরু বা শেষ হতে পারে না। নামটি তৈরিতে খালি থাকলে, একটি অনন্য নাম তৈরি হবে। উদাহরণ: files/123-456
displayName
string
ঐচ্ছিক। File
জন্য মানব-পাঠযোগ্য প্রদর্শন নাম। প্রদর্শনের নামটি স্পেস সহ দৈর্ঘ্যে 512 অক্ষরের বেশি হওয়া উচিত নয়। উদাহরণ: "স্বাগত ছবি"
mimeType
string
শুধুমাত্র আউটপুট। ফাইলের MIME প্রকার।
sizeBytes
string ( int64 format)
শুধুমাত্র আউটপুট। ফাইলের আকার বাইটে।
createTime
string ( Timestamp
format)
শুধুমাত্র আউটপুট। File
কখন তৈরি করা হয়েছিল তার টাইমস্ট্যাম্প।
RFC3339 UTC "জুলু" ফর্ম্যাটে একটি টাইমস্ট্যাম্প, ন্যানোসেকেন্ড রেজোলিউশন এবং নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা। উদাহরণ: "2014-10-02T15:01:23Z"
এবং "2014-10-02T15:01:23.045123456Z"
।
updateTime
string ( Timestamp
format)
শুধুমাত্র আউটপুট। File
কখন আপডেট করা হয়েছিল তার টাইমস্ট্যাম্প৷
RFC3339 UTC "জুলু" ফর্ম্যাটে একটি টাইমস্ট্যাম্প, ন্যানোসেকেন্ড রেজোলিউশন এবং নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা। উদাহরণ: "2014-10-02T15:01:23Z"
এবং "2014-10-02T15:01:23.045123456Z"
।
expirationTime
string ( Timestamp
format)
শুধুমাত্র আউটপুট। File
কখন মুছে ফেলা হবে তার টাইমস্ট্যাম্প। File
মেয়াদ শেষ হওয়ার জন্য নির্ধারিত হলে শুধুমাত্র সেট করুন।
RFC3339 UTC "জুলু" ফর্ম্যাটে একটি টাইমস্ট্যাম্প, ন্যানোসেকেন্ড রেজোলিউশন এবং নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা। উদাহরণ: "2014-10-02T15:01:23Z"
এবং "2014-10-02T15:01:23.045123456Z"
।
sha256Hash
string ( bytes format)
শুধুমাত্র আউটপুট। আপলোড করা বাইটের SHA-256 হ্যাশ।
একটি base64-এনকোডেড স্ট্রিং।
uri
string
শুধুমাত্র আউটপুট। File
ইউরি।
state
enum ( State
)
শুধুমাত্র আউটপুট। ফাইলের প্রসেসিং অবস্থা।
error
object ( Status
)
শুধুমাত্র আউটপুট। ফাইল প্রসেসিং ব্যর্থ হলে ত্রুটি স্থিতি।
metadata
। ফাইলের জন্য মেটাডেটা। metadata
নিম্নলিখিতগুলির মধ্যে একটি হতে পারে: videoMetadata
object ( VideoMetadata
)
শুধুমাত্র আউটপুট। একটি ভিডিওর জন্য মেটাডেটা।
JSON প্রতিনিধিত্ব |
---|
{ "name": string, "displayName": string, "mimeType": string, "sizeBytes": string, "createTime": string, "updateTime": string, "expirationTime": string, "sha256Hash": string, "uri": string, "state": enum ( |
ভিডিও মেটাডেটা
একটি ভিডিও File
জন্য মেটাডেটা।
videoDuration
string ( Duration
format)
ভিডিওর সময়কাল।
নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা সহ সেকেন্ডে একটি সময়কাল, ' s
' দিয়ে শেষ হয়৷ উদাহরণ: "3.5s"
।
JSON প্রতিনিধিত্ব |
---|
{ "videoDuration": string } |
রাজ্য
একটি ফাইলের জীবনচক্রের জন্য রাজ্যগুলি৷
Enums | |
---|---|
STATE_UNSPECIFIED | ডিফল্ট মান। এই মানটি ব্যবহার করা হয় যদি রাষ্ট্রটি বাদ দেওয়া হয়। |
PROCESSING | ফাইল প্রক্রিয়া করা হচ্ছে এবং এখনও অনুমান জন্য ব্যবহার করা যাবে না. |
ACTIVE | ফাইল প্রক্রিয়া করা হয় এবং অনুমান জন্য উপলব্ধ. |
FAILED | ফাইল প্রক্রিয়াকরণ ব্যর্থ হয়েছে. |
স্ট্যাটাস
Status
টাইপ একটি লজিক্যাল ত্রুটি মডেলকে সংজ্ঞায়িত করে যা REST API এবং RPC API সহ বিভিন্ন প্রোগ্রামিং পরিবেশের জন্য উপযুক্ত। এটি gRPC দ্বারা ব্যবহৃত হয়। প্রতিটি Status
বার্তায় তিনটি টুকরো ডেটা থাকে: ত্রুটি কোড, ত্রুটি বার্তা এবং ত্রুটির বিবরণ।
আপনি API ডিজাইন গাইডে এই ত্রুটি মডেল এবং এটির সাথে কীভাবে কাজ করবেন সে সম্পর্কে আরও জানতে পারেন।
code
integer
স্ট্যাটাস কোড, যা google.rpc.Code
এর একটি enum মান হওয়া উচিত।
message
string
একটি বিকাশকারী-মুখী ত্রুটি বার্তা, যা ইংরেজিতে হওয়া উচিত। যেকোন ব্যবহারকারী-মুখী ত্রুটি বার্তা স্থানীয়করণ করা উচিত এবং google.rpc.Status.details
ক্ষেত্রে পাঠানো উচিত, অথবা ক্লায়েন্ট দ্বারা স্থানীয়করণ করা উচিত।
details[]
object
ত্রুটির বিবরণ বহন করে এমন বার্তাগুলির একটি তালিকা৷ APIs ব্যবহার করার জন্য বার্তা প্রকারের একটি সাধারণ সেট আছে।
একটি নির্বিচারী ধরনের ক্ষেত্র ধারণকারী একটি বস্তু. একটি অতিরিক্ত ক্ষেত্র "@type"
এ টাইপ সনাক্তকারী একটি URI রয়েছে৷ উদাহরণ: { "id": 1234, "@type": "types.example.com/standard/id" }
।
JSON প্রতিনিধিত্ব |
---|
{ "code": integer, "message": string, "details": [ { "@type": string, field1: ..., ... } ] } |