图像接口 (Image Generation)

图像接口提供强大的AI图像生成、编辑和分析能力，支持文本生成图像、图像变体创建、图像编辑等多种功能。

接口地址


POST https://aiapi.services/v1/images/generations

鉴权方式

所有请求需要在HTTP头中包含您的API密钥：


Authorization: Bearer YOUR_API_KEY

支持的模型

Imagen 4.0 系列

imagen-4.0-ultra-generate-001 - Imagen 4.0 Ultra，最高质量的图像生成
imagen-4.0-generate-001 - Imagen 4.0标准版，高质量图像生成
imagen-4.0-fast-generate-001 - Imagen 4.0快速版，优化生成速度

Imagen 3.0 系列

imagen-3.0-generate-002 - Imagen 3.0标准版(v2)，成熟稳定的图像生成
imagen-3.0-fast-generate-001 - Imagen 3.0快速版，快速图像生成

完整模型列表请查看可用模型。

请求参数

必需参数

参数	类型	说明
`prompt`	string	图像描述文本，详细描述您想要生成的图像
`model`	string	要使用的模型ID，例如 `imagen-4.0-generate-001`

可选参数

参数	类型	默认值	说明
`n`	integer	1	要生成的图像数量（1-10）
`size`	string	`1024x1024`	图像尺寸，支持 `256x256`、`512x512`、`1024x1024`、`1024x1792`、`1792x1024`
`quality`	string	`standard`	图像质量：`standard` 或 `hd`
`style`	string	`vivid`	图像风格：`vivid` (生动) 或 `natural` (自然)
`response_format`	string	`url`	返回格式：`url` 或 `b64_json`
`user`	string	-	终端用户的唯一标识符

代码示例

cURL


curl https://aiapi.services/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "imagen-4.0-generate-001",
    "prompt": "一只可爱的橘猫坐在窗台上看着窗外的雨景，水彩画风格",
    "n": 1,
    "size": "1024x1024",
    "quality": "hd"
  }'

Python


import requests
 
response = requests.post(
  'https://aiapi.services/v1/images/generations',
  headers={
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  json={
    'model': 'imagen-4.0-generate-001',
    'prompt': '一只可爱的橘猫坐在窗台上看着窗外的雨景，水彩画风格',
    'n': 1,
    'size': '1024x1024',
    'quality': 'hd'
  }
)
 
data = response.json()
image_url = data['data'][0]['url']
print(f'图像URL: {image_url}')
 
# 下载图像
import urllib.request
urllib.request.urlretrieve(image_url, 'generated_image.png')
print('图像已保存为 generated_image.png')

JavaScript


const response = await fetch('https://aiapi.services/v1/images/generations', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'imagen-4.0-generate-001',
    prompt: '一只可爱的橘猫坐在窗台上看着窗外的雨景，水彩画风格',
    n: 1,
    size: '1024x1024',
    quality: 'hd'
  })
});
 
const data = await response.json();
console.log('图像URL:', data.data[0].url);

Go


package main
 
import (
  "bytes"
  "encoding/json"
  "fmt"
  "io"
  "net/http"
)
 
func main() {
  url := "https://aiapi.services/v1/images/generations"
 
  payload := map[string]interface{}{
    "model": "imagen-4.0-generate-001",
    "prompt": "一只可爱的橘猫坐在窗台上看着窗外的雨景，水彩画风格",
    "n": 1,
    "size": "1024x1024",
    "quality": "hd",
  }
 
  jsonData, _ := json.Marshal(payload)
 
  req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
  req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
  req.Header.Set("Content-Type", "application/json")
 
  client := &http.Client{}
  resp, _ := client.Do(req)
  defer resp.Body.Close()
 
  body, _ := io.ReadAll(resp.Body)
  fmt.Println(string(body))
}

Rust


use reqwest::header::{HeaderMap, HeaderValue, AUTHORIZATION, CONTENT_TYPE};
use serde_json::json;
 
#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = reqwest::Client::new();
 
    let mut headers = HeaderMap::new();
    headers.insert(AUTHORIZATION, HeaderValue::from_static("Bearer YOUR_API_KEY"));
    headers.insert(CONTENT_TYPE, HeaderValue::from_static("application/json"));
 
    let payload = json!({
        "model": "imagen-4.0-generate-001",
        "prompt": "一只可爱的橘猫坐在窗台上看着窗外的雨景，水彩画风格",
        "n": 1,
        "size": "1024x1024",
        "quality": "hd"
    });
 
    let response = client
        .post("https://aiapi.services/v1/images/generations")
        .headers(headers)
        .json(&payload)
        .send()
        .await?;
 
    let data: serde_json::Value = response.json().await?;
    println!("图像URL: {}", data["data"][0]["url"]);
 
    Ok(())
}

PHP


<?php
 
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://aiapi.services/v1/images/generations");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer YOUR_API_KEY",
    "Content-Type: application/json"
]);
 
$data = [
    "model" => "imagen-4.0-generate-001",
    "prompt" => "一只可爱的橘猫坐在窗台上看着窗外的雨景，水彩画风格",
    "n" => 1,
    "size" => "1024x1024",
    "quality" => "hd"
];
 
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
 
$response = curl_exec($ch);
curl_close($ch);
 
$result = json_decode($response, true);
$image_url = $result['data'][0]['url'];
echo "图像URL: " . $image_url . "\n";
 
// 下载图像
file_put_contents('generated_image.png', file_get_contents($image_url));
echo "图像已保存为 generated_image.png\n";
?>

Ruby


require 'net/http'
require 'json'
require 'open-uri'
 
uri = URI('https://aiapi.services/v1/images/generations')
request = Net::HTTP::Post.new(uri)
request['Authorization'] = 'Bearer YOUR_API_KEY'
request['Content-Type'] = 'application/json'
 
request.body = {
  model: 'imagen-4.0-generate-001',
  prompt: '一只可爱的橘猫坐在窗台上看着窗外的雨景，水彩画风格',
  n: 1,
  size: '1024x1024',
  quality: 'hd'
}.to_json
 
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end
 
data = JSON.parse(response.body)
image_url = data['data'][0]['url']
puts "图像URL: #{image_url}"
 
# 下载图像
File.write('generated_image.png', URI.open(image_url).read)
puts "图像已保存为 generated_image.png"

响应格式

标准响应


{
  "created": 1702548600,
  "data": [
    {
      "url": "https://oaidalleapiprodscus.blob.core.windows.net/private/...",
      "revised_prompt": "一幅水彩画风格的作品，描绘了一只可爱的橘色猫咪坐在窗台上，凝视着窗外的雨景。雨滴在玻璃上形成美丽的纹路..."
    }
  ]
}

Base64响应 (response_format: “b64_json”)


{
  "created": 1702548600,
  "data": [
    {
      "b64_json": "iVBORw0KGgoAAAANSUhEUgAA...",
      "revised_prompt": "一幅水彩画风格的作品..."
    }
  ]
}

响应字段说明

字段	类型	说明
`created`	integer	创建时间戳
`data`	array	生成的图像数组
`data[].url`	string	图像URL（24小时有效）
`data[].b64_json`	string	Base64编码的图像数据
`data[].revised_prompt`	string	模型优化后的提示词

图像接口 (Image Generation)

接口地址

鉴权方式

支持的模型

Imagen 4.0 系列

Imagen 3.0 系列

请求参数

必需参数

可选参数

代码示例

cURL

Python

JavaScript

Go

Rust

PHP

Ruby

响应格式

标准响应

Base64响应 (response_format: “b64_json”)

响应字段说明

相关资源