Bild till bild API

Bild till bild API är en funktion som låter dig integrera Meshys AI-bildredigeringsmöjligheter i din egen applikation. Transformera och redigera befintliga bilder med hjälp av referensbilder och textuppmaningar med våra kraftfulla AI-modeller.

POST/openapi/v1/image-to-image

Skapa en Bild till bild-uppgift

Detta endpoint tillåter dig att skapa en ny Bild till bild-uppgift. Se Bild till bild-uppgiftsobjektet för att se vilka egenskaper som ingår i Bild till bild-uppgiftsobjektet.

Parametrar

  • Name
    ai_model
    Type
    string
    Obligatorisk
    Description

    ID för modellen som ska användas för bildgenerering.

    Tillgängliga värden:

    • nano-banana: Standardmodell (3 credits per bild)
    • nano-banana-2: Balanserad modell med starkare kapacitet än standard (6 credits per bild)
    • nano-banana-pro: Pro-modell med förbättrad kvalitet (9 credits per bild)
    • gpt-image-2: OpenAI GPT Image 2, en högupplöst bildredigeringsmodell (12 credits per bild)
  • Name
    prompt
    Type
    string
    Obligatorisk
    Description

    En textbeskrivning av den transformation eller redigering du vill tillämpa på referensbilderna.

  • Name
    reference_image_urls
    Type
    array
    Obligatorisk
    Description

    En array av 1 till 5 referensbilder som ska användas för bildredigeringsuppgiften. Vi stöder för närvarande .jpg, .jpeg och .png format.

    Det finns två sätt att tillhandahålla varje bild:

    • Offentligt tillgänglig URL: En URL som är tillgänglig från det offentliga internet.
    • Data URI: En base64-kodad data URI av bilden. Exempel på en data URI: data:image/jpeg;base64,<your base64-encoded image data>.
  • Name
    generate_multi_view
    Type
    boolean
    standard false
    Description

    När den är inställd på true, genereras en flervybild som visar motivet från flera vinklar.

    När generate_multi_view är true, kan inte aspect_ratio-parametern ställas in.

  • Name
    aspect_ratio
    Type
    string
    standard 1:1
    Description

    Ange bildens bildförhållande. Tillåtna värden beror på den valda ai_model:

    • nano-banana, nano-banana-2, nano-banana-pro: 1:1, 16:9, 9:16, 4:3, 3:4
    • gpt-image-2: 1:1, 16:9, 9:16, 3:2, 2:3

    Tillgängliga värden:

    • 1:1: Fyrkantigt format
    • 16:9: Widescreen landskap
    • 9:16: Widescreen porträtt
    • 4:3: Standard landskap (stöds inte av gpt-image-2)
    • 3:4: Standard porträtt (stöds inte av gpt-image-2)
    • 3:2: Landskap (endast stöds av gpt-image-2)
    • 2:3: Porträtt (endast stöds av gpt-image-2)
  • Name
    remove_background
    Type
    boolean
    standard false
    Description

    När den är inställd på true, returneras utgångsbilden som en transparent RGBA PNG med bakgrunden borttagen, så att du kan komponera motivet på vilken bakgrund som helst.

Returnerar

result-egenskapen i svaret innehåller uppgiftens id för den nyligen skapade Bild till bild-uppgiften.

Felmodeller

  • Name
    400 - Bad Request
    Description

    Begäran var oacceptabel. Vanliga orsaker:

    • Saknad parameter: En nödvändig parameter (t.ex. ai_model, prompt, reference_image_urls) saknas.
    • Ogiltigt bildformat: En eller flera referensbilder är inte stödda format.
    • Oåtkomlig URL: En eller flera reference_image_urls kunde inte laddas ner.
    • Ogiltig parameter: aspect_ratio är inte ett av de tillåtna värdena för den valda ai_model.
    • Konflikt: generate_multi_view och aspect_ratio kan inte användas samtidigt.
  • Name
    401 - Unauthorized
    Description

    Autentisering misslyckades. Kontrollera din API-nyckel.

  • Name
    402 - Payment Required
    Description

    Otillräckliga credits för att utföra denna uppgift.

  • Name
    429 - Too Many Requests
    Description

    Du har överskridit din hastighetsgräns.

Request

POST
/openapi/v1/image-to-image
# Transform a reference image with a text prompt
curl https://api.meshy.ai/openapi/v1/image-to-image \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "ai_model": "nano-banana",
    "prompt": "Transform this into a cyberpunk style artwork",
    "reference_image_urls": [
      "<your publicly accessible image url or base64-encoded data URI>"
    ]
  }'


 ## Using Data URI example
curl https://api.meshy.ai/openapi/v1/image-to-image \
  -X POST \
  -H "Authorization: Bearer ${YOUR_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{
    "ai_model": "nano-banana",
    "prompt": "Transform this into a cyberpunk style artwork",
    "reference_image_urls": [
      "data:image/png;base64,${YOUR_BASE64_ENCODED_IMAGE_DATA}"
    ]
  }'

Response

{
  "result": "018a210d-8ba4-705c-b111-1f1776f7f578"
}
GET/openapi/v1/image-to-image/:id

Hämta en Bild till bild-uppgift

Detta endpoint tillåter dig att hämta en Bild till bild-uppgift givet ett giltigt uppgifts-id. Se Objektet för Bild till bild-uppgiften för att se vilka egenskaper som ingår i objektet för Bild till bild-uppgiften.

Parametrar

  • Name
    id
    Type
    path
    Description

    Unik identifierare för Bild till bild-uppgiften att hämta.

Returnerar

Svaret innehåller objektet för Bild till bild-uppgiften. Kontrollera Objektet för Bild till bild-uppgiften avsnittet för detaljer.

Förfrågan

GET
/openapi/v1/image-to-image/018a210d-8ba4-705c-b111-1f1776f7f578
curl https://api.meshy.ai/openapi/v1/image-to-image/018a210d-8ba4-705c-b111-1f1776f7f578 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Svar

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "image-to-image",
  "ai_model": "nano-banana",
  "prompt": "Transform this into a cyberpunk style artwork",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1692771650657,
  "started_at": 1692771667037,
  "finished_at": 1692771669037,
  "expires_at": 1692771679037,
  "image_urls": [
    "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/image.png?Expires=***"
  ]
}
DELETE/openapi/v1/image-to-image/:id

Ta bort en Bild till bild-uppgift

Denna endpoint tar permanent bort en Bild till bild-uppgift, inklusive alla associerade bilder och data. Denna åtgärd är oåterkallelig.

Sökvägsparametrar

  • Name
    id
    Type
    path
    Description

    ID för den Bild till bild-uppgift som ska tas bort.

Returnerar

Returnerar 200 OK vid framgång.

Request

DELETE
/openapi/v1/image-to-image/018a210d-8ba4-705c-b111-1f1776f7f578
curl --request DELETE \
  --url https://api.meshy.ai/openapi/v1/image-to-image/018a210d-8ba4-705c-b111-1f1776f7f578 \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

Response

// Returns 200 Ok on success.
GET/openapi/v1/image-to-image

Lista Bild till bild-uppgifter

Detta endpoint tillåter dig att hämta en lista över Bild till bild-uppgifter.

Parametrar

  • Name
    page_num
    Type
    integer
    Description

    Sidnummer för paginering. Börjar och standard är 1.

  • Name
    page_size
    Type
    integer
    Description

    Sidstorleksgräns. Standard är 10 objekt. Max tillåtet är 50 objekt.

  • Name
    sort_by
    Type
    string
    Description

    Fält att sortera efter. Tillgängliga värden:

    • +created_at: Sortera efter skapandetid i stigande ordning.
    • -created_at: Sortera efter skapandetid i fallande ordning.

Returnerar

Returnerar en paginerad lista över Bild till bild-uppgiftsobjekten.

Request

GET
/openapi/v1/image-to-image
curl https://api.meshy.ai/openapi/v1/image-to-image?page_size=10 \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Response

[
  {
    "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
    "type": "image-to-image",
    "ai_model": "nano-banana",
    "prompt": "Transform this into a cyberpunk style artwork",
    "status": "SUCCEEDED",
    "progress": 100,
    "created_at": 1692771650657,
    "started_at": 1692771667037,
    "finished_at": 1692771669037,
    "expires_at": 1692771679037,
    "image_urls": [
      "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/image.png?Expires=***"
    ]
  }
]
GET/openapi/v1/image-to-image/:id/stream

Strömma en Bild till bild-uppgift

Denna endpoint strömmar realtidsuppdateringar för en Bild till bild-uppgift med hjälp av Server-Sent Events (SSE).

Parametrar

  • Name
    id
    Type
    path
    Description

    Unik identifierare för Bild till bild-uppgiften att strömma.

Returnerar

Returnerar en ström av The Image to Image Task Objects som Server-Sent Events.

För PENDING eller IN_PROGRESS uppgifter kommer svarströmmen endast att inkludera nödvändiga progress och status fält.

Request

GET
/openapi/v1/image-to-image/018a210d-8ba4-705c-b111-1f1776f7f578/stream
curl -N https://api.meshy.ai/openapi/v1/image-to-image/018a210d-8ba4-705c-b111-1f1776f7f578/stream \
-H "Authorization: Bearer ${YOUR_API_KEY}"

Response Stream

// Error event example
event: error
data: {
  "status_code": 404,
  "message": "Task not found"
}

// Message event examples illustrate task progress.
// For PENDING or IN_PROGRESS tasks, the response stream will not include all fields.
event: message
data: {
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "progress": 0,
  "status": "PENDING"
}

event: message
data: {
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "image-to-image",
  "ai_model": "nano-banana",
  "prompt": "Transform this into a cyberpunk style artwork",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1692771650657,
  "started_at": 1692771667037,
  "finished_at": 1692771669037,
  "expires_at": 1692771679037,
  "image_urls": [
    "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/image.png?Expires=***"
  ]
}

Objektet för Bild till bild-uppgift

Objektet för Bild till bild-uppgift är en arbetsenhet som Meshy håller reda på för att generera en bild från referensbilder och en textprompt-inmatning. Objektet har följande egenskaper:

Egenskaper

  • Name
    id
    Type
    string
    Description

    Unik identifierare för uppgiften. Även om vi använder ett k-sorterbart UUID för uppgifts-id:n som implementeringsdetalj, bör du inte göra några antaganden om formatet på id:t.

  • Name
    type
    Type
    string
    Description

    Typen av bildgenereringsuppgift. För Bild till bild-uppgifter kommer detta alltid att vara image-to-image.

  • Name
    ai_model
    Type
    string
    Description

    AI-modellen som används för denna uppgift. Möjliga värden är nano-banana, nano-banana-2, nano-banana-pro eller gpt-image-2.

  • Name
    prompt
    Type
    string
    Description

    Textprompten som användes för att styra bildtransformationen.

  • Name
    status
    Type
    string
    Description

    Status för uppgiften. Möjliga värden är en av PENDING, IN_PROGRESS, SUCCEEDED, FAILED, CANCELED.

  • Name
    progress
    Type
    integer
    Description

    Framsteg för uppgiften. Om uppgiften inte har startat ännu, kommer denna egenskap att vara 0. När uppgiften har lyckats, kommer detta att bli 100.

  • Name
    created_at
    Type
    timestamp
    Description

    Tidsstämpel för när uppgiften skapades, i millisekunder.

    En tidsstämpel representerar antalet millisekunder som har förflutit sedan 1 januari 1970 UTC, enligt RFC 3339-standarden. Till exempel, fredag 1 september 2023 12:00:00 GMT representeras som 1693569600000. Detta gäller för alla tidsstämplar i Meshy API.

  • Name
    started_at
    Type
    timestamp
    Description

    Tidsstämpel för när uppgiften startades, i millisekunder. Om uppgiften inte har startat ännu, kommer denna egenskap att vara 0.

  • Name
    finished_at
    Type
    timestamp
    Description

    Tidsstämpel för när uppgiften avslutades, i millisekunder. Om uppgiften inte har avslutats ännu, kommer denna egenskap att vara 0.

  • Name
    expires_at
    Type
    timestamp
    Description

    Tidsstämpel för när uppgiftsresultatet går ut, i millisekunder.

  • Name
    preceding_tasks
    Type
    integer
    Description

    Antalet föregående uppgifter.

    Värdet av detta fält är meningsfullt endast om uppgiftens status är PENDING.

  • Name
    image_urls
    Type
    array
    Description

    En array av nedladdningsbara URL:er till de genererade bilderna. När generate_multi_view är aktiverat, innehåller denna array tre bild-URL:er som representerar olika visningsvinklar. Annars innehåller den en enda bild-URL.

  • Name
    task_error
    Type
    object
    Description

    Felformationer för misslyckade uppgifter. Se Fel för hela task_error-objektreferensen.

  • Name
    consumed_credits
    Type
    integer
    Description

    Antalet credits som förbrukats av denna uppgift. Finns när uppgiftens status är PENDING, IN_PROGRESS eller SUCCEEDED. Returnerar 0 för FAILED uppgifter (credits återbetalas vid misslyckande).

Exempel på Bild till bild-uppgiftsobjekt

{
  "id": "018a210d-8ba4-705c-b111-1f1776f7f578",
  "type": "image-to-image",
  "ai_model": "nano-banana",
  "prompt": "Transform this into a cyberpunk style artwork",
  "status": "SUCCEEDED",
  "progress": 100,
  "created_at": 1692771650657,
  "started_at": 1692771667037,
  "finished_at": 1692771669037,
  "expires_at": 1692771679037,
  "preceding_tasks": 0,
  "image_urls": [
    "https://assets.meshy.ai/***/tasks/018a210d-8ba4-705c-b111-1f1776f7f578/output/image.png?Expires=***"
  ],
  "task_error": {

    "message": ""

  },

  "consumed_credits": 3
}