典名词元典名词元首页
API 文档三方工具教程
AI 模型接口图像Banana

文生图/图生图

POST/api/v1/image/generation

Header Parameters

Authorization*string

格式: Authorization: Bearer sk-xxxxxx

Request Body

application/json

_action*string

固定值i

model*string

模型名称,支持:

NB

NBP

NB2

Value in"NB" | "NBP" | "NB2"
messages*array<object>

消息列表,仅支持一条消息

[]?object
role?string

消息角色,固定值:user

content?array<object>

内容列表

[]?object
type*string

内容类型:text 或 image_url

text?string

文本内容(type=text 时必填)

image_item?object

图片信息(type=image_url 时必填)

image_url*string

图片 URL

n?integer

NB/NBP/NB2 仅支持 1

size?string

图片宽高比,支持:

1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, 1:4, 1:8, 4:1, 8:1(1:4, 1:8, 4:1, 8:1 仅 NB2 支持)

quality?string

图片分辨率,NB支持1K,NBP 支持 1K/2K/4K,NB2 支持 512/1K/2K/4K

response_modalities?array<string>

响应模态,如传入必须包含 "IMAGE"

[]?string
tools?array<object>

工具定义,NBP/NB2 支持,NB 不支持

[]?object
type*string

工具类型,固定值:function

function*object

函数定义

name*string

函数名,如 GWebSearch(网页搜索)

extra_body?object

模型扩展配置

g_model?object

Google/Gemini 模型配置

thinking_config?object

思考模式配置,仅 NB2 支持

thinking_level?string

思考等级,仅 NB2 支持,取值仅支持 MINIMAL、HIGH

Response Body

application/json

curl -X POST "https://api.aa.com.cn/api/v1/image/generation" \  -H "Authorization: string" \  -H "Content-Type: application/json" \  -d '{    "_action": "string",    "model": "NB",    "messages": [      {        "role": "string",        "content": [          {            "type": "string",            "text": "string",            "image_item": {              "image_url": "string"            }          }        ]      }    ],    "n": 0,    "size": "string",    "quality": "string",    "response_modalities": [      "string"    ],    "tools": [      {        "type": "string",        "function": {          "name": "string"        }      }    ],    "extra_body": {      "g_model": {        "thinking_config": {          "thinking_level": "string"        }      }    }  }'
{
  "code": 0,
  "data": {
    "urls": [
      "string"
    ],
    "usage": {
      "images": 0,
      "seconds": 0,
      "input_tokens": 0,
      "total_tokens": 0,
      "output_tokens": 0
    },
    "expired": "string",
    "task_id": "string",
    "task_status": "string"
  },
  "message": "string",
  "request_id": "string"
}