生成图片

使用我们的 txt2img API 从文本提示创建图片。

端点

POST /api/generate-image

请求体

{
  "prompt": "山脉上美丽的日落，鲜艳的色彩",
  "imageSize": "1_1",
  "outputFormat": "png",
  "mode": "text_to_image"
}

| 参数 - 类型 - 必需 - 描述 | |------|------|------|------| | prompt - string - 是 - 图片的文字描述（最多2000字符）| | imageSize - string - 否 - 宽高比：1_1、16_9、9_16等（默认：1_1）| | outputFormat - string - 否 - 输出格式：png 或 jpeg（默认：png）| | mode - string - 是 - 生成模式：text_to_image 或 image_to_image | | referenceImages - array - 否* - img2img模式的图片URL数组（*image_to_image模式必需）|

响应

{
  "success": true,
  "taskId": "task_abc123",
  "status": "processing",
  "estimatedTime": 30
}

检查状态

GET /api/task-status/{taskId}

响应（已完成）

{
  "success": true,
  "status": "completed",
  "imageUrl": "https://cdn.gempix2.top/images/abc123.png",
  "downloadUrl": "https://gempix2.top/api/download/abc123"
}

图生图

使用 img2img 技术转换现有图片。

请求示例

{
  "prompt": "转换为油画风格，印象派艺术",
  "mode": "image_to_image",
  "referenceImages": [
    "https://example.com/image1.jpg",
    "https://example.com/image2.jpg"
  ],
  "imageSize": "16_9"
}

错误处理

错误响应

{
  "success": false,
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "您的积分不足"
  }
}

常见错误代码

| 代码 - 描述 | |------|------| | INVALID_API_KEY - API 密钥无效或已过期 | | INSUFFICIENT_CREDITS - 积分不足无法生成图片 | | INVALID_PROMPT - 提示词为空或太长 | | INVALID_IMAGE_URL - 参考图片 URL 无效 | | RATE_LIMIT_EXCEEDED - 请求过多，请减速 |

速率限制

免费计划：每分钟 10 个请求
专业计划：每分钟 100 个请求
企业版：自定义限制

代码示例

Node.js

const axios = require('axios');

async function generateImage() {
  const response = await axios.post(
    'https://gempix2.top/api/generate-image',
    {
      prompt: '霓虹灯闪烁的未来城市',
      imageSize: '16_9',
      mode: 'text_to_image'
    },
    {
      headers: {
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
      }
    }
  );
  
  console.log(response.data);
}

Python

import requests

def generate_image():
    response = requests.post(
        'https://gempix2.top/api/generate-image',
        json={
            'prompt': '有山脉的美丽风景',
            'imageSize': '16_9',
            'mode': 'text_to_image'
        },
        headers={
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/json'
        }
    )
    
    print(response.json())

支持

需要帮助？联系我们：

立即开始使用 Gempix2 AI - nano banana 2 API 进行构建！

API 参考

概述

基础 URL

身份验证