Quickstart Guide

pip install requests

import requests
import time

API_KEY = "nk_live_your_api_key_here"
BASE_URL = "https://eccoapi.com/api/v1"

def generate_pro_image(prompt, aspect_ratio="16:9", image_size="4K"):
    """Generate image with NanoBanana Pro (async mode)"""
    payload = {
        "prompt": prompt,
        "aspectRatio": aspect_ratio,
        "imageSize": image_size,
        "callbackUrl": "https://your-server.com/webhook"  # optional
    }

    headers = {
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json"
    }

    # Submit job (returns 202 instantly)
    response = requests.post(
        f"{BASE_URL}/api/v1/nanobananapro/generate",
        headers=headers,
        json=payload
    )

    if response.status_code != 202:
        print(f"Error: {response.json()}")
        return False

    job_id = response.json()["jobId"]
    print(f"Job submitted: {job_id}")

    # Poll for result
    while True:
        time.sleep(3)
        status_resp = requests.get(
            f"{BASE_URL}/jobs/{job_id}",
            headers={"Authorization": f"Bearer {API_KEY}"}
        )
        job = status_resp.json()

        if job["status"] == "completed":
            asset_url = job["result"]["data"]["assetUrl"]
            img = requests.get(asset_url)
            with open("generated_4k.png", "wb") as f:
                f.write(img.content)
            print(f"Image saved! Cost: $" + str(job["result"]["meta"]["cost"]))
            return True

        if job["status"] == "failed":
            print(f"Failed: {job.get('error', 'Unknown error')}")
            return False

        print(f"Status: {job['status']}...")

# Generate an image
generate_pro_image("ultra detailed mountain landscape at golden hour", "16:9", "4K")

{
  "code": 200,
  "msg": "Success",
  "data": {
    "assetUrl": "https://<signed-url>",
    "assetKey": "user/<userId>/nanobananapro/2026/02/17/<uuid>.png",
    "mimeType": "image/png",
    "bytes": 2097152
  },
  "meta": {
    "model": "nanobananapro",
    "cost": 0.10,
    "remaining_credits": 9.90,
    "settings": {
      "aspectRatio": "16:9",
      "imageSize": "4K",
      "useGoogleSearch": false
    },
    "asset_url_ttl_seconds": 900,
    "asset_retention_days": 30
  }
}