Nano Banana Images API Integrationsbeskrivning

Denna artikel beskriver integration och användning av Nano Banana Images API. Detta gränssnitt stöder två funktioner: bildgenerering (generate) och billedredigering (edit).

Ansökningsprocess

För att använda Nano Banana Images API, börja med att gå till Ace Data Cloud-konsolen för att hämta din API-token, som du ska spara.

Om du inte har loggat in eller registrerat dig, kommer du automatiskt att omdirigeras till inloggningssidan för att registrera dig och logga in, och efter att ha slutfört detta kommer du automatiskt att återvända till den aktuella sidan. En API-token räcker för att anropa alla tjänster på plattformen, du behöver inte ansöka separat för varje tjänst. Första ansökan ger en gratis kvot, så att du kan prova gratis; om kvoten tar slut kan du ladda på allmän balans i konsolen.

📘 Fullständig dokumentation: Nano Banana Images API →

Gränssnittsöversikt

Bas-URL: https://api.acedata.cloud
Endpoint: POST /nano-banana/images
Autentisering: HTTP-header med authorization: Bearer {token}
Begärningshuvud:
- accept: application/json
- content-type: application/json
Åtgärd (action):
- generate: Generera bild baserat på textprompt
- edit: Redigera baserat på given bild
Modell (model) (valfritt):
- nano-banana (standard): Baserad på Gemini 2.5 Flash Image, snabb hastighet, låg kostnad
- nano-banana-2-lite: Baserad på Gemini 3.1 Flash Lite Image, stödjer endast 1K, snabb genereringshastighet
- nano-banana-2: Baserad på Gemini 3.1 Flash Image Preview, Pro-kvalitet + Flash-hastighet
- nano-banana-pro: Baserad på Gemini 3 Pro Image Preview, högsta kvalitet
- nano-banana:official, nano-banana-2-lite:official, nano-banana-2:official, nano-banana-pro:official: Officiella versioner av motsvarande modeller, bättre bildkvalitet och stabilitet, olika prissättning
Asynkron callback: Valfritt, ta emot meddelande om uppgiftens slutförande och resultat via callback_url
Antal bilder: Valfritt, ange 1–4 bilder via count, standard är 1 bild; varje bild genereras genom en separat anrop; vanliga tekniska misslyckanden eller säkerhetsavvisningar från leverantören påverkar endast det aktuella anropet, övriga framgångsrika bilder returneras som vanligt och debiteras baserat på det faktiska antalet framgångsrika bilder

Snabbstart: Generera bild (`action=generate`)

Minimala nödvändiga parametrar: action, prompt När du bara vill generera en bild baserat på en prompt, ställ in action till generate och ge en tydlig prompt.

Begärningsexempel (cURL)

curl -X POST 'https://api.acedata.cloud/nano-banana/images' \
  -H 'authorization: Bearer {token}' \
  -H 'accept: application/json' \
  -H 'content-type: application/json' \
  -d '{
    "action": "generate",
    "model": "nano-banana-pro",
    "prompt": "Ett fotorealistiskt närbildsporträtt av en gammal japansk keramiker med djupa, sol-etsade rynkor och ett varmt, vetande leende. Han inspekterar noggrant en nyglaserad tekopp. Miljön är hans rustika, solbelysta verkstad. Scenen belyses av mjukt, gyllene timmesljus som strömmar genom ett fönster och framhäver den fina texturen av leran. Fångad med en 85 mm porträttlins, vilket resulterar i en mjuk, suddig bakgrund (bokeh). Den övergripande stämningen är lugn och mästerlig. Vertikal porträttorientering.",
    "count": 1
  }'

Begärningsexempel (Python)

import requests

url = "https://api.acedata.cloud/nano-banana/images"
headers = {
    "authorization": "Bearer {token}",
    "accept": "application/json",
    "content-type": "application/json",
}
payload = {
    "action": "generate",
    "model": "nano-banana-pro",
    "prompt": (
        "Ett fotorealistiskt närbildsporträtt av en gammal japansk keramiker "
        "med djupa, sol-etsade rynkor och ett varmt, vetande leende. Han inspekterar noggrant "
        "en nyglaserad tekopp. Miljön är hans rustika, solbelysta verkstad. Scenen belyses "
        "av mjukt, gyllene timmesljus som strömmar genom ett fönster och framhäver den fina "
        "texturen av leran. Fångad med en 85 mm porträttlins, vilket resulterar i en mjuk, "
        "suddig bakgrund (bokeh). Den övergripande stämningen är lugn och mästerlig. "
        "Vertikal porträttorientering."
    ),
    "count": 1
}
resp = requests.post(url, json=payload, headers=headers)
print(resp.json())

Framgångsrik retur exempel

{
  "success": true,
  "task_id": "70e6931b-6e34-43db-9e36-8765e2809d04",
  "trace_id": "60df8d38-f265-4986-aec7-75c9220bced2",
  "data": [
    {
      "prompt": "Ett fotorealistiskt närbildsporträtt av en gammal japansk keramiker med djupa, sol-etsade rynkor och ett varmt, vetande leende. Han inspekterar noggrant en nyglaserad tekopp. Miljön är hans rustika, solbelysta verkstad. Scenen belyses av mjukt, gyllene timmesljus som strömmar genom ett fönster och framhäver den fina texturen av leran. Fångad med en 85 mm porträttlins, vilket resulterar i en mjuk, suddig bakgrund (bokeh). Den övergripande stämningen är lugn och mästerlig. Vertikal porträttorientering.",
      "image_url": "https://platform2.cdn.acedata.cloud/nanobanana/1d0160b4-93f9-4229-8926-ea9ef0bed336.png"
    }
  ]
}

Fältspecifikationer

success: Om denna begäran var framgångsrik.
task_id: Uppgifts-ID.
trace_id: Spårnings-ID, för att underlätta felsökning.
count: Antalet bilder som begärts för generering eller redigering, stödjer 1–4, standard är 1. data innehåller endast de bilder som genererades framgångsrikt och debiteras baserat på det faktiska antalet returnerade bilder. Varje genereringsanrop använder alltid leverantörens ursprungliga säkerhetspolicy; om ett anrop avvisas påverkar det inte andra framgångsrika anrop, om alla anrop avvisas returneras 403.
data[]: Resultatlista.
- prompt: Används för att generera prompt (återkoppling).
- image_url: Direktlänk URL till den genererade bilden.

Obs: /nano-banana/images kräver endast action och prompt för att generera en bild

Redigera bild (`action=edit`)

När du vill redigera en befintlig bild, ställ in action till edit och skicka in en lista med länkar till bilder som ska redigeras via image_urls (1 eller flera bilder), samtidigt som du ger en beskrivning av redigeringsmålet med prompt. Till exempel kan vi här ge en bild av en person och en bild av kläder, så att personen kan klä på sig dessa kläder, och vi kan samtidigt skicka in bildlänkar och ange åtgärden som edit, URL:er kan vara HTTP-URL:er, offentligt tillgängliga länkar med https eller http protokoll, eller så kan de vara Base64-kodade bilder, som data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAA+gAAAVGCAMAAAA6u2FyAAADAFBMVEXq6uwdHCEeHyMdHS....

Begärningsexempel (cURL)

curl -X POST 'https://api.acedata.cloud/nano-banana/images' \
  -H 'authorization: Bearer {token}' \
  -H 'accept: application/json' \
  -H 'content-type: application/json' \
  -d '{
    "action": "edit",
    "prompt": "låt denna man ha på sig denna T-shirt",
    "image_urls": [
      "https://cdn.acedata.cloud/v8073y.png",
      "https://cdn.acedata.cloud/44xlah.png"
    ],
    "count": 1
  }'

Exempel på begäran (Python)

import requests

url = "https://api.acedata.cloud/nano-banana/images"
headers = {
    "authorization": "Bearer {token}",
    "accept": "application/json",
    "content-type": "application/json",
}
payload = {
    "action": "edit",
    "prompt": "låt denna man ha på sig denna T-shirt",
    "image_urls": [
        "https://cdn.acedata.cloud/v8073y.png",
        "https://cdn.acedata.cloud/44xlah.png"
    ],
    "count": 1
}
resp = requests.post(url, json=payload, headers=headers)
print(resp.json())

Exempel på framgångsrikt svar

{
  "success": true,
  "task_id": "93f11baf-347b-4bb4-9520-8653cb46d6a3",
  "trace_id": "a9063166-26ed-4451-85b5-54e896817c69",
  "data": [
    {
      "prompt": "låt denna man ha på sig denna T-shirt",
      "image_url": "https://platform.cdn.acedata.cloud/nanobanana/8e9e0253-26f4-45b9-b3f8-ac1aed1c284b.png"
    }
  ]
}

Fältnotation

image_urls[]: Lista över URL:er för bilder som ska redigeras (måste vara offentligt tillgängliga). Flera bilder kan skickas, tjänsten kommer att kombinera dessa material med prompt för att slutföra redigeringen.
Övriga fält är desamma som för “generera bild” svar.

Asynkron callback (valfritt, rekommenderas)

Generering eller redigering kan ta viss tid. För att undvika att långvariga anslutningar upptar resurser, rekommenderas att använda callback_url för Webhook callback:

Lägg till callback_url i begärans kropp, till exempel din servers Webhook-adress (måste vara offentligt tillgänglig, stödja POST JSON).
API:et kommer att omedelbart returnera ett svar som innehåller task_id (eller ett grundläggande resultat).
När uppgiften är klar kommer plattformen att skicka den fullständiga JSON:en till callback_url med POST. Du kan koppla begäran till resultatet med task_id.

Exempel på callback-last (fältsstruktur är densamma som för synkront framgångsrikt svar):

{
  "success": true,
  "task_id": "6a97bf49-df50-4129-9e46-119aa9fca73c",
  "trace_id": "9b4b1ff3-90f2-470f-b082-1061ec2948cc",
  "data": [
    {
      "prompt": "en vit siamesisk katt",
      "image_url": "https://platform.cdn.acedata.cloud/nanobanana/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.png"
    }
  ]
}

Felhantering

Vid misslyckad anrop kommer standardfelformat och spårnings-ID att returneras. Vanliga fel är:

400 token_mismatched: Begäran är ogiltig eller parameterfel.
400 api_not_implemented: Gränssnittet är inte implementerat (vänligen kontakta support).
401 invalid_token: Autentisering misslyckades eller saknar token.
403 forbidden: Leverantörens inbyggda säkerhetspolicy avvisade begäran eller genererade resultat. Denna anrop kommer inte att returnera bilder och kommer inte att debiteras; flera bildbegärningar kan fortfarande returnera och debiteras för andra lyckade anrop.
429 too_many_requests: Begärningsfrekvensen överskrider gränsen.
500 api_error: Serverfel.

Exempel på felrespons

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "Internt serverfel."
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

Parameteröversikt och anmärkningar

Obligatoriska: action, prompt
Redigeringsspecifik: image_urls (array, minst 1 post)
Valfritt: model (standard nano-banana, valfritt nano-banana-2-lite, nano-banana-2, nano-banana-pro, eller motsvarande :official officiella kanalversion), aspect_ratio (bredd-höjd-förhållande, som 1:1, 16:9), resolution (upplösning, som 1K, 2K, 4K; nano-banana-2-lite stöder endast 1K), callback_url (för asynkron callback)
Headers: Måste tillhandahålla authorization: Bearer {token}; accept rekommenderas att sättas till application/json
Bildåtkomst: image_urls måste vara direktlänkar som är offentligt tillgängliga (HTTP/HTTPS), rekommenderas att använda HTTPS
Idempotens och spårning: Bevara task_id och trace_id för att underlätta felsökning och resultatkoppling

Getting Started

AI Samtal

AI Bild

AI Video

AI Ljud

Web & Data

CAPTCHA

Identitet

Proxy

Advanced

Coding

Nano Banana Images API Integrationsbeskrivning

Ansökningsprocess

Gränssnittsöversikt

Snabbstart: Generera bild (`action=generate`)

Begärningsexempel (cURL)

Begärningsexempel (Python)

Framgångsrik retur exempel

Fältspecifikationer

Redigera bild (`action=edit`)

Begärningsexempel (cURL)

Exempel på begäran (Python)

Exempel på framgångsrikt svar

Fältnotation

Asynkron callback (valfritt, rekommenderas)

Felhantering

Exempel på felrespons

Parameteröversikt och anmärkningar

​Ansökningsprocess

​Gränssnittsöversikt

​Snabbstart: Generera bild (action=generate)

​Begärningsexempel (cURL)

​Begärningsexempel (Python)

​Framgångsrik retur exempel

​Fältspecifikationer

​Redigera bild (action=edit)

​Begärningsexempel (cURL)

​Exempel på begäran (Python)

​Exempel på framgångsrikt svar

​Fältnotation

​Asynkron callback (valfritt, rekommenderas)

​Felhantering

​Exempel på felrespons

​Parameteröversikt och anmärkningar

Ansökningsprocess

Gränssnittsöversikt

Snabbstart: Generera bild (`action=generate`)

Begärningsexempel (cURL)

Begärningsexempel (Python)

Framgångsrik retur exempel

Fältspecifikationer

Redigera bild (`action=edit`)

Begärningsexempel (cURL)

Exempel på begäran (Python)

Exempel på framgångsrikt svar

Fältnotation

Asynkron callback (valfritt, rekommenderas)

Felhantering

Exempel på felrespons

Parameteröversikt och anmärkningar