模型调用文档

{
  "prompt": "A cinematic street food scene at night, warm lights, handheld camera movement",
  "model_code": "sora_studio"
}

import requests

BASE_URL = "http://localhost:8095"
API_KEY = "aa_live_xxxxx"

headers = {
    "X-API-Key": API_KEY,
    "Content-Type": "application/json",
}

payload = {
  "prompt": "A cinematic street food scene at night, warm lights, handheld camera movement",
  "model_code": "sora_studio"
}

response = requests.post(
    f"{BASE_URL}/api/v1/aa/openapi/sora/tasks",
    headers=headers,
    json=payload,
)

response.raise_for_status()
print(response.json())

{
  "prompt": "Turn this reference image into a luxury perfume ad video with slow dolly-in and floating particles",
  "model_code": "sora_studio",
  "image_url": "https://example.com/reference.jpg",
  "reference_image_name": "product-reference.jpg"
}

import requests

BASE_URL = "http://localhost:8095"
API_KEY = "aa_live_xxxxx"

headers = {
    "X-API-Key": API_KEY,
    "Content-Type": "application/json",
}

payload = {
  "prompt": "Turn this reference image into a luxury perfume ad video with slow dolly-in and floating particles",
  "model_code": "sora_studio",
  "image_url": "https://example.com/reference.jpg",
  "reference_image_name": "product-reference.jpg"
}

response = requests.post(
    f"{BASE_URL}/api/v1/aa/openapi/sora/tasks",
    headers=headers,
    json=payload,
)

response.raise_for_status()
print(response.json())

import requests

BASE_URL = "http://localhost:8095"
API_KEY = "aa_live_xxxxx"

headers = {
    "X-API-Key": API_KEY,
}

response = requests.get(
    f"{BASE_URL}/api/v1/aa/sora/tasks/task_202604150001_abc12345",
    headers=headers,
)

response.raise_for_status()
print(response.json())

{
  "prompt": "A cinematic street food scene at night, warm lights, handheld camera movement",
  "model_code": "sora_fast"
}

import requests

BASE_URL = "http://localhost:8095"
API_KEY = "aa_live_xxxxx"

headers = {
    "X-API-Key": API_KEY,
    "Content-Type": "application/json",
}

payload = {
  "prompt": "A cinematic street food scene at night, warm lights, handheld camera movement",
  "model_code": "sora_fast"
}

response = requests.post(
    f"{BASE_URL}/api/v1/aa/openapi/sora/tasks",
    headers=headers,
    json=payload,
)

response.raise_for_status()
print(response.json())

{
  "prompt": "Turn this reference image into a luxury perfume ad video with slow dolly-in and floating particles",
  "model_code": "sora_fast",
  "image_url": "https://example.com/reference.jpg",
  "reference_image_name": "product-reference.jpg"
}

import requests

BASE_URL = "http://localhost:8095"
API_KEY = "aa_live_xxxxx"

headers = {
    "X-API-Key": API_KEY,
    "Content-Type": "application/json",
}

payload = {
  "prompt": "Turn this reference image into a luxury perfume ad video with slow dolly-in and floating particles",
  "model_code": "sora_fast",
  "image_url": "https://example.com/reference.jpg",
  "reference_image_name": "product-reference.jpg"
}

response = requests.post(
    f"{BASE_URL}/api/v1/aa/openapi/sora/tasks",
    headers=headers,
    json=payload,
)

response.raise_for_status()
print(response.json())

import requests

BASE_URL = "http://localhost:8095"
API_KEY = "aa_live_xxxxx"

headers = {
    "X-API-Key": API_KEY,
}

response = requests.get(
    f"{BASE_URL}/api/v1/aa/sora/tasks/task_202604150001_abc12345",
    headers=headers,
)

response.raise_for_status()
print(response.json())

{
  "model": "veo",
  "stream": false,
  "messages": [
    {
      "role": "user",
      "content": "Aerial shot flying through a futuristic city at sunrise, cinematic light, smooth camera motion"
    }
  ],
  "aspect_ratio": "16:9"
}

import requests

BASE_URL = "http://localhost:8095"
API_KEY = "aa_live_xxxxx"

headers = {
    "X-API-Key": API_KEY,
    "Content-Type": "application/json",
}

payload = {
  "model": "veo",
  "stream": False,
  "messages": [
    {
      "role": "user",
      "content": "Aerial shot flying through a futuristic city at sunrise, cinematic light, smooth camera motion"
    }
  ],
  "aspect_ratio": "16:9"
}

response = requests.post(
    f"{BASE_URL}/v1/chat/completions",
    headers=headers,
    json=payload,
)

response.raise_for_status()
print(response.json())

import requests

BASE_URL = "http://localhost:8095"
API_KEY = "aa_live_xxxxx"

headers = {
    "X-API-Key": API_KEY,
}

response = requests.get(
    f"{BASE_URL}/v1/tasks/evt_20260415_abcd1234",
    headers=headers,
)

response.raise_for_status()
print(response.json())

{
  "model": "veo_fast",
  "stream": false,
  "messages": [
    {
      "role": "user",
      "content": "Aerial shot flying through a futuristic city at sunrise, cinematic light, smooth camera motion"
    }
  ],
  "aspect_ratio": "16:9"
}

import requests

BASE_URL = "http://localhost:8095"
API_KEY = "aa_live_xxxxx"

headers = {
    "X-API-Key": API_KEY,
    "Content-Type": "application/json",
}

payload = {
  "model": "veo_fast",
  "stream": False,
  "messages": [
    {
      "role": "user",
      "content": "Aerial shot flying through a futuristic city at sunrise, cinematic light, smooth camera motion"
    }
  ],
  "aspect_ratio": "16:9"
}

response = requests.post(
    f"{BASE_URL}/v1/chat/completions",
    headers=headers,
    json=payload,
)

response.raise_for_status()
print(response.json())

import requests

BASE_URL = "http://localhost:8095"
API_KEY = "aa_live_xxxxx"

headers = {
    "X-API-Key": API_KEY,
}

response = requests.get(
    f"{BASE_URL}/v1/tasks/evt_20260415_abcd1234",
    headers=headers,
)

response.raise_for_status()
print(response.json())

{
  "model": "veo_reference",
  "stream": false,
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "Create a premium product launch video based on these references, keep the bottle shape and gold cap consistent"
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "https://example.com/ref-1.jpg"
          }
        }
      ]
    }
  ]
}

import requests

BASE_URL = "http://localhost:8095"
API_KEY = "aa_live_xxxxx"

headers = {
    "X-API-Key": API_KEY,
    "Content-Type": "application/json",
}

payload = {
  "model": "veo_reference",
  "stream": False,
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "Create a premium product launch video based on these references, keep the bottle shape and gold cap consistent"
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "https://example.com/ref-1.jpg"
          }
        }
      ]
    }
  ]
}

response = requests.post(
    f"{BASE_URL}/v1/chat/completions",
    headers=headers,
    json=payload,
)

response.raise_for_status()
print(response.json())

import requests

BASE_URL = "http://localhost:8095"
API_KEY = "aa_live_xxxxx"

headers = {
    "X-API-Key": API_KEY,
}

response = requests.get(
    f"{BASE_URL}/v1/tasks/evt_20260415_abcd1234",
    headers=headers,
)

response.raise_for_status()
print(response.json())

{
  "model": "gpt-image-2",
  "messages": [
    {
      "role": "user",
      "content": "Create a clean 16:9 product hero image of a ceramic cup on a wooden table with soft daylight."
    }
  ]
}

import requests

BASE_URL = "http://localhost:8095"
API_KEY = "aa_live_xxxxx"

headers = {
    "X-API-Key": API_KEY,
    "Content-Type": "application/json",
}

payload = {
  "model": "gpt-image-2",
  "messages": [
    {
      "role": "user",
      "content": "Create a clean 16:9 product hero image of a ceramic cup on a wooden table with soft daylight."
    }
  ]
}

response = requests.post(
    f"{BASE_URL}/v1/chat/completions",
    headers=headers,
    json=payload,
)

response.raise_for_status()
print(response.json())

{
  "model": "gpt-image-2",
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "Keep the bottle shape unchanged and generate a premium 1:1 poster style product shot."
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "https://example.com/reference.png"
          }
        }
      ]
    }
  ]
}

import requests

BASE_URL = "http://localhost:8095"
API_KEY = "aa_live_xxxxx"

headers = {
    "X-API-Key": API_KEY,
    "Content-Type": "application/json",
}

payload = {
  "model": "gpt-image-2",
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "Keep the bottle shape unchanged and generate a premium 1:1 poster style product shot."
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "https://example.com/reference.png"
          }
        }
      ]
    }
  ]
}

response = requests.post(
    f"{BASE_URL}/v1/chat/completions",
    headers=headers,
    json=payload,
)

response.raise_for_status()
print(response.json())

{
  "model": "nanobanana",
  "prompt": "Minimal luxury skincare product shot on travertine, warm daylight, premium packaging",
  "aspect_ratio": "1:1",
  "quality": "2k"
}

import requests

BASE_URL = "http://localhost:8095"
API_KEY = "aa_live_xxxxx"

headers = {
    "X-API-Key": API_KEY,
    "Content-Type": "application/json",
}

payload = {
  "model": "nanobanana",
  "prompt": "Minimal luxury skincare product shot on travertine, warm daylight, premium packaging",
  "aspect_ratio": "1:1",
  "quality": "2k"
}

response = requests.post(
    f"{BASE_URL}/v1/images/generations",
    headers=headers,
    json=payload,
)

response.raise_for_status()
print(response.json())

{
  "model": "gemini-2.5-flash-image",
  "prompt": "Keep the product shape unchanged, switch the background to a clean beige studio and add soft shadows",
  "image1": "https://example.com/reference-1.png",
  "image2": "https://example.com/reference-2.png",
  "resolution_preset": "4K",
  "aspect_ratio": "4:3",
  "num_images": 1
}

import requests

BASE_URL = "http://localhost:8095"
API_KEY = "aa_live_xxxxx"

headers = {
    "X-API-Key": API_KEY,
    "Content-Type": "application/json",
}

payload = {
  "model": "gemini-2.5-flash-image",
  "prompt": "Keep the product shape unchanged, switch the background to a clean beige studio and add soft shadows",
  "image1": "https://example.com/reference-1.png",
  "image2": "https://example.com/reference-2.png",
  "resolution_preset": "4K",
  "aspect_ratio": "4:3",
  "num_images": 1
}

response = requests.post(
    f"{BASE_URL}/v1/images/generations",
    headers=headers,
    json=payload,
)

response.raise_for_status()
print(response.json())

{
  "model": "nanobanana",
  "prompt": "Minimal luxury skincare product shot on travertine, warm daylight, premium packaging",
  "aspect_ratio": "1:1",
  "quality": "2k",
  "async": true
}

import requests

BASE_URL = "http://localhost:8095"
API_KEY = "aa_live_xxxxx"

headers = {
    "X-API-Key": API_KEY,
    "Content-Type": "application/json",
}

payload = {
  "model": "nanobanana",
  "prompt": "Minimal luxury skincare product shot on travertine, warm daylight, premium packaging",
  "aspect_ratio": "1:1",
  "quality": "2k",
  "async": True
}

response = requests.post(
    f"{BASE_URL}/v1/images/generations",
    headers=headers,
    json=payload,
)

response.raise_for_status()
print(response.json())

{
  "model": "nanobanana",
  "quality": "2k",
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "Keep the product shape unchanged, switch the background to a clean beige studio and add soft shadows"
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "https://example.com/reference.png"
          }
        }
      ]
    }
  ]
}

import requests

BASE_URL = "http://localhost:8095"
API_KEY = "aa_live_xxxxx"

headers = {
    "X-API-Key": API_KEY,
    "Content-Type": "application/json",
}

payload = {
  "model": "nanobanana",
  "quality": "2k",
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "Keep the product shape unchanged, switch the background to a clean beige studio and add soft shadows"
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "https://example.com/reference.png"
          }
        }
      ]
    }
  ]
}

response = requests.post(
    f"{BASE_URL}/v1/chat/completions",
    headers=headers,
    json=payload,
)

response.raise_for_status()
print(response.json())

{
  "model": "nanobanana",
  "quality": "4k",
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "Combine the product from image 1, the background style from image 2, and the lighting from image 3 to create a premium product shot"
        },
        {
          "type": "image_url",
          "image_url": { "url": "https://example.com/product.png" }
        },
        {
          "type": "image_url",
          "image_url": { "url": "https://example.com/background-style.png" }
        },
        {
          "type": "image_url",
          "image_url": { "url": "https://example.com/lighting-ref.png" }
        }
      ]
    }
  ]
}

import requests

BASE_URL = "http://localhost:8095"
API_KEY = "aa_live_xxxxx"

headers = {
    "X-API-Key": API_KEY,
    "Content-Type": "application/json",
}

payload = {
  "model": "nanobanana",
  "quality": "4k",
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "Combine the product from image 1, the background style from image 2, and the lighting from image 3 to create a premium product shot"
        },
        {
          "type": "image_url",
          "image_url": { "url": "https://example.com/product.png" }
        },
        {
          "type": "image_url",
          "image_url": { "url": "https://example.com/background-style.png" }
        },
        {
          "type": "image_url",
          "image_url": { "url": "https://example.com/lighting-ref.png" }
        }
      ]
    }
  ]
}

response = requests.post(
    f"{BASE_URL}/v1/chat/completions",
    headers=headers,
    json=payload,
)

response.raise_for_status()
print(response.json())

import requests

BASE_URL = "http://localhost:8095"
API_KEY = "aa_live_xxxxx"

headers = {
    "X-API-Key": API_KEY,
}

response = requests.get(
    f"{BASE_URL}/v1/tasks/evt_20260415_img1234",
    headers=headers,
)

response.raise_for_status()
print(response.json())

{
  "model": "nanobanana_pro",
  "prompt": "Minimal luxury skincare product shot on travertine, warm daylight, premium packaging",
  "aspect_ratio": "1:1",
  "quality": "2k"
}

import requests

BASE_URL = "http://localhost:8095"
API_KEY = "aa_live_xxxxx"

headers = {
    "X-API-Key": API_KEY,
    "Content-Type": "application/json",
}

payload = {
  "model": "nanobanana_pro",
  "prompt": "Minimal luxury skincare product shot on travertine, warm daylight, premium packaging",
  "aspect_ratio": "1:1",
  "quality": "2k"
}

response = requests.post(
    f"{BASE_URL}/v1/images/generations",
    headers=headers,
    json=payload,
)

response.raise_for_status()
print(response.json())

{
  "model": "gemini-3-pro-image-preview",
  "prompt": "Keep the product shape unchanged, switch the background to a clean beige studio and add soft shadows",
  "image1": "https://example.com/reference-1.png",
  "image2": "https://example.com/reference-2.png",
  "resolution_preset": "4K",
  "aspect_ratio": "4:3",
  "num_images": 1
}

import requests

BASE_URL = "http://localhost:8095"
API_KEY = "aa_live_xxxxx"

headers = {
    "X-API-Key": API_KEY,
    "Content-Type": "application/json",
}

payload = {
  "model": "gemini-3-pro-image-preview",
  "prompt": "Keep the product shape unchanged, switch the background to a clean beige studio and add soft shadows",
  "image1": "https://example.com/reference-1.png",
  "image2": "https://example.com/reference-2.png",
  "resolution_preset": "4K",
  "aspect_ratio": "4:3",
  "num_images": 1
}

response = requests.post(
    f"{BASE_URL}/v1/images/generations",
    headers=headers,
    json=payload,
)

response.raise_for_status()
print(response.json())

{
  "model": "nanobanana_pro",
  "prompt": "Minimal luxury skincare product shot on travertine, warm daylight, premium packaging",
  "aspect_ratio": "1:1",
  "quality": "2k",
  "async": true
}

import requests

BASE_URL = "http://localhost:8095"
API_KEY = "aa_live_xxxxx"

headers = {
    "X-API-Key": API_KEY,
    "Content-Type": "application/json",
}

payload = {
  "model": "nanobanana_pro",
  "prompt": "Minimal luxury skincare product shot on travertine, warm daylight, premium packaging",
  "aspect_ratio": "1:1",
  "quality": "2k",
  "async": True
}

response = requests.post(
    f"{BASE_URL}/v1/images/generations",
    headers=headers,
    json=payload,
)

response.raise_for_status()
print(response.json())

{
  "model": "nanobanana_pro",
  "quality": "2k",
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "Keep the product shape unchanged, switch the background to a clean beige studio and add soft shadows"
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "https://example.com/reference.png"
          }
        }
      ]
    }
  ]
}

import requests

BASE_URL = "http://localhost:8095"
API_KEY = "aa_live_xxxxx"

headers = {
    "X-API-Key": API_KEY,
    "Content-Type": "application/json",
}

payload = {
  "model": "nanobanana_pro",
  "quality": "2k",
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "Keep the product shape unchanged, switch the background to a clean beige studio and add soft shadows"
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "https://example.com/reference.png"
          }
        }
      ]
    }
  ]
}

response = requests.post(
    f"{BASE_URL}/v1/chat/completions",
    headers=headers,
    json=payload,
)

response.raise_for_status()
print(response.json())

{
  "model": "nanobanana_pro",
  "quality": "4k",
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "Combine the product from image 1, the background style from image 2, and the lighting from image 3 to create a premium product shot"
        },
        {
          "type": "image_url",
          "image_url": { "url": "https://example.com/product.png" }
        },
        {
          "type": "image_url",
          "image_url": { "url": "https://example.com/background-style.png" }
        },
        {
          "type": "image_url",
          "image_url": { "url": "https://example.com/lighting-ref.png" }
        }
      ]
    }
  ]
}

import requests

BASE_URL = "http://localhost:8095"
API_KEY = "aa_live_xxxxx"

headers = {
    "X-API-Key": API_KEY,
    "Content-Type": "application/json",
}

payload = {
  "model": "nanobanana_pro",
  "quality": "4k",
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "Combine the product from image 1, the background style from image 2, and the lighting from image 3 to create a premium product shot"
        },
        {
          "type": "image_url",
          "image_url": { "url": "https://example.com/product.png" }
        },
        {
          "type": "image_url",
          "image_url": { "url": "https://example.com/background-style.png" }
        },
        {
          "type": "image_url",
          "image_url": { "url": "https://example.com/lighting-ref.png" }
        }
      ]
    }
  ]
}

response = requests.post(
    f"{BASE_URL}/v1/chat/completions",
    headers=headers,
    json=payload,
)

response.raise_for_status()
print(response.json())

import requests

BASE_URL = "http://localhost:8095"
API_KEY = "aa_live_xxxxx"

headers = {
    "X-API-Key": API_KEY,
}

response = requests.get(
    f"{BASE_URL}/v1/tasks/evt_20260415_img1234",
    headers=headers,
)

response.raise_for_status()
print(response.json())