图像生成（OpenAI 原生格式）

向支持图像生成的模型提交提示词。可用模型和参数以 /v1/models 返回结果为准。图像编辑请参阅图像编辑；Gemini 和通义千问兼容入口分别参阅 Gemini 原生格式 和 通义千问格式。

请求

POST /v1/images/generations
Content-Type: application/json
Authorization: Bearer sk-your-api-key

调用示例

cURL

curl -X POST "https://www.walmind.cn/v1/images/generations" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $API_KEY" \
  -d '{
    "model": "your-image-model",
    "prompt": "一座坐落在海边的未来城市",
    "n": 1,
    "size": "1024x1024"
  }'

JavaScript

const response = await fetch('https://www.walmind.cn/v1/images/generations', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    Authorization: `Bearer ${process.env.API_KEY}`,
  },
  body: JSON.stringify({
    model: 'your-image-model',
    prompt: '一座坐落在海边的未来城市',
    n: 1,
    size: '1024x1024',
  }),
});

console.log(await response.json());

Python

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["API_KEY"],
    base_url="https://www.walmind.cn/v1",
)

result = client.images.generate(
    model="your-image-model",
    prompt="一座坐落在海边的未来城市",
    size="1024x1024",
)
print(result.data)

Go

package main

import (
    "bytes"
    "fmt"
    "io"
    "net/http"
    "os"
)

func main() {
    body := []byte(`{"model":"your-image-model","prompt":"一座坐落在海边的未来城市","n":1,"size":"1024x1024"}`)
    req, _ := http.NewRequest("POST", "https://www.walmind.cn/v1/images/generations", bytes.NewReader(body))
    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("Authorization", "Bearer "+os.Getenv("API_KEY"))

    resp, err := http.DefaultClient.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()
    result, _ := io.ReadAll(resp.Body)
    fmt.Println(string(result))
}

Java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class GenerateImage {
    public static void main(String[] args) throws Exception {
        String body = "{"model":"your-image-model","prompt":"一座坐落在海边的未来城市","n":1,"size":"1024x1024"}";
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://www.walmind.cn/v1/images/generations"))
            .header("Content-Type", "application/json")
            .header("Authorization", "Bearer " + System.getenv("API_KEY"))
            .POST(HttpRequest.BodyPublishers.ofString(body))
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

请求参数

参数	类型	说明
model	string	图片模型 ID；部分部署可省略
prompt	string	图片描述，必填
n	integer	生成数量
size	string	图片尺寸，例如 1024x1024

响应示例

{
  "created": 1710000000,
  "data": [{"url": "https://example.com/generated-image.png"}]
}