Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Formati tal-Immaġni: URL u Base64

Lezzjoni 1 / 12 Aġġornat 3 ta’ Novembru 2026 Bidbieni
F'din il-paġna
  1. Tibgħat Immaġni lil Grok
  2. URL Dirett
  3. Ikkodifikat Base64 (Data URI)
  4. Differenzi Ewlenin bejn URL u Base64
  5. Taħlit ta’ Test u Immaġni
  6. Punti Ewlenin

Aġġornat fit-3 ta’ Novembru, 2026. Bl-API tar-Risposti, l-oġġetti input_image u input_text imorru fil-content ta’ messaġġ {"role": "user", ...}, mhux direttament f’input. L-eżempju Python qabel kien isejaħ client.responses.create() fuq il-klijent xai-sdk, li ma għandux dan il-metodu, u kien jikteb iċ-ċavetta tal-API fil-kodiċi: issa juża user(...) u image(...) mill-SDK, biċ-ċavetta moqrija mill-ambjent. Żdied twissija ta’ xAI dwar il-ħażna tal-istorja. Il-kodiċi ġie vverifikat ma’ xai-sdk 1.21.0. Sors: Fehim tal-Immaġni.

Tibgħat Immaġni lil Grok

Grok janalizza immaġni Il-mudelli Grok minn grok-4.5 ‘il quddiem jinkludu kapaċitajiet tal-viżjoni. Tista’ tibgħat immaġni waħda jew aktar fit-talbiet tal-API tiegħek, u l-mudell janalizzahom biex iwieġeb il-mistoqsijiet tiegħek. Dan jissejjaħ fehim tal-immaġni, jew viżjoni multimodali.

Qabel ma tidħol fil-każijiet ta’ użu, huwa essenzjali li tħakkar iż-żewġ formati ta’ sottomissjoni tal-immaġni appoġġjati mill-API ta’ xAI.

2
Formati appoġġjati
20 MiB
Daqs massimu għal kull immaġni
JPG/PNG
Formati aċċettati
Mhux limitat
Numru ta' immaġni

URL Dirett

L-aktar metodu sempliċi huwa li tipprovdi l-URL pubblika ta’ immaġni. Il-mudell se jniżżilha u janalizzaha awtomatikament.

Bl-API tar-Risposti (endpoint prinċipali):

{
  "model": "grok-4.5",
  "input": [
    {
      "role": "user",
      "content": [
        {
          "type": "input_image",
          "image_url": "https://exemple.com/photo-produit.jpg"
        },
        {
          "type": "input_text",
          "text": "Iddeskrivi din l-immaġni fid-dettall."
        }
      ]
    }
  ]
}

xAI jirrakkomanda li meta tibgħat immaġni, ma taħżinx l-istorja tat-talba u r-risposta fuq is-servers tagħhom, inkella t-talba tista’ tfalli: bl-API tar-Risposti, għaddi "store": false.

Bl-API tal-Kompletamenti taċ-Chat (antik, kompatibbli ma’ OpenAI):

{
  "model": "grok-4.5",
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "image_url",
          "image_url": {
            "url": "https://exemple.com/photo-produit.jpg"
          }
        },
        {
          "type": "text",
          "text": "Iddeskrivi din l-immaġni fid-dettall."
        }
      ]
    }
  ]
}

L-URL irid jipponta lejn fajl ta’ immaġni aċċessibbli pubblikament. Jekk l-immaġni tkun wara awtentikazzjoni jew CDN protett, uża l-format Base64 minflok.

Ikkodifikat Base64 (Data URI)

It-tieni format jinvolvi li tikkodifika l-immaġni direttament fit-talba bħala stringa Base64 preċeduta minn prefiss MIME. Dan huwa l-metodu ideali meta taħdem ma’ immaġni lokali, screenshots, jew fajls iġġenerati dinamikament.

{
  "type": "input_image",
  "image_url": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQ..."
}

Il-prefiss data:image/jpeg;base64, jgħid lill-mudell it-tip MIME tal-immaġni. Aġġustah skont il-format:

  • data:image/jpeg;base64, għal fajls JPG/JPEG
  • data:image/png;base64, għal fajls PNG

Kif Tikkodifika Immaġni f’Python

import base64

with open("photo.jpg", "rb") as f:
    image_data = base64.standard_b64encode(f.read()).decode("utf-8")

image_url = f"data:image/jpeg;base64,{image_data}"

Kif Tikkodifika f’JavaScript/Node.js

import { readFileSync } from 'fs';

const imageData = readFileSync('photo.jpg').toString('base64');
const imageUrl = `data:image/jpeg;base64,${imageData}`;

Differenzi Ewlenin bejn URL u Base64

Kriterju URL Base64
Daqs tat-talba Ħafif (biss l-URL) Tqil (+33% meta mqabbel mal-fajl oriġinali)
Aċċessibbiltà Teħtieġ immaġni pubblika Jaħdem ma' kwalunkwe fajl lokali
Latency Tniżżil mis-server Dejta direttament fit-talba
Każ ta' użu tipiku Immaġni tal-web, CDN, ħażna cloud Fajls lokali, screenshots, uploads

Taħlit ta’ Test u Immaġni

Il-content ta’ messaġġ jaċċetta array imħallat ta’ oġġetti input_image u input_text, f’kwalunkwe ordni: tista’ tibdel liberament bejn test u immaġni. Bl-SDK nativ ta’ xAI, l-istess messaġġ jinbena b’user(), li jaċċetta test u immaġni maħluqa minn image() f’sekwenza:

from xai_sdk import Client
from xai_sdk.chat import image, user

client = Client()  # iċ-ċavetta moqrija minn XAI_API_KEY

chat = client.chat.create(model="grok-4.5")
chat.append(
    user(
        "Qabbel dawn iż-żewġ ritratti:",
        image(image_url="https://exemple.com/photo1.jpg", detail="high"),
        image(image_url="https://exemple.com/photo2.jpg", detail="high"),
        "X'inhu d-differenzi ewlenin?",
    )
)

response = chat.sample()
print(response.content)

image() taċċetta URL pubblika jew Data URI Base64.

Punti Ewlenin

  • Żewġ formati ta’ immaġni huma appoġġjati: URL Dirett u Base64 (Data URI)
  • Il-formati aċċettati huma biss JPG, JPEG, u PNG
  • Kull immaġni m’għandhiex taqbeż 20 MiB
  • In-numru ta’ immaġni għal kull talba huwa mhux limitat
  • L-API tar-Risposti tpoġġi input_image fil-content ta’ messaġġ; il-Kompletamenti taċ-Chat jużaw partijiet image_url; l-SDK ta’ xAI juża image() ġewwa user()
  • Ippreferi l-URL għal immaġni pubbliċi u Base64 għal fajls lokali