视觉与图像生成

# 此示例使用公网可访问的图片 URL；如果是本地图片，请看 Python 或 Node.js 示例。
curl https://moxus.cloud/v1/chat/completions \
  -H "Authorization: Bearer 你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4",
    "messages": [
      {
        "role": "user",
        "content": [
          {"type": "text", "text": "请描述这张图片，并列出其中的关键信息。"},
          {
            "type": "image_url",
            "image_url": {
              "url": "https://example.com/photo.jpg"
            }
          }
        ]
      }
    ]
  }'

# base64 是 Python 标准库，用来把本地图片转成可放入 JSON 的文本。
import base64
import httpx
from openai import OpenAI

# 只需替换这两项：你的 API 密钥，以及本地图片的文件名或完整路径。
API_KEY = "你的密钥"
IMAGE_PATH = "photo.jpg"
# JPEG 使用 image/jpeg；如果 IMAGE_PATH 指向 PNG，请改为 image/png。
IMAGE_MIME_TYPE = "image/jpeg"

client = OpenAI(
    api_key=API_KEY,
    base_url="https://moxus.cloud/v1",
    # 直接连接 Moxus AI，不读取系统或终端代理环境变量。
    http_client=httpx.Client(trust_env=False, timeout=60.0),
)

# 读取本地图片文件，并编码成 Base64 字符串。
# "rb" 中 r 表示读取，b 表示二进制模式；图片必须以二进制模式读取。
with open(IMAGE_PATH, "rb") as image_file:
    image_base64 = base64.b64encode(image_file.read()).decode("utf-8")

response = client.chat.completions.create(
    model="gpt-5.4",
    messages=[
        {
            "role": "user",
            "content": [
                {"type": "text", "text": "请描述这张图片，并列出其中的关键信息。"},
                {
                    "type": "image_url",
                    "image_url": {
                        # 前缀告诉模型后面是该格式图片的 Base64 内容。
                        "url": f"data:{IMAGE_MIME_TYPE};base64,{image_base64}",
                    },
                },
            ],
        }
    ],
)

print(response.choices[0].message.content)

import OpenAI from "openai";

// readFileSync 是 Node.js 标准库方法，用来读取本地图片文件。
import { readFileSync } from "node:fs";

// 将 photo.png 放在 .mjs 文件同一项目文件夹；文件名或格式不同时同步修改下面两项。
const API_KEY = "你的密钥";
const IMAGE_PATH = "photo.png";
const IMAGE_MIME_TYPE = "image/png";

const client = new OpenAI({
  apiKey: API_KEY,
  baseURL: "https://moxus.cloud/v1",
});

// 把本地图片转成 Base64 字符串，方便放入 JSON 请求体。
const imageBase64 = readFileSync(IMAGE_PATH).toString("base64");

const response = await client.chat.completions.create({
  model: "gpt-5.4",
  messages: [
    {
      role: "user",
      content: [
        { type: "text", text: "请描述这张图片，并列出其中的关键信息。" },
        {
          type: "image_url",
          image_url: {
            // 前缀表示后面是该格式图片的 Base64 内容。
            url: `data:${IMAGE_MIME_TYPE};base64,${imageBase64}`,
          },
        },
      ],
    },
  ],
});

console.log(response.choices[0].message.content);

# prompt 是图片描述；size、n 等参数是否可用取决于所选图像模型。
curl https://moxus.cloud/v1/images/generations \
  -H "Authorization: Bearer 你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-image",
    "prompt": "一张现代办公桌上的智能台灯产品图，白色背景，柔和棚拍光线",
    "n": 1,
    "size": "1024x1024"
  }'

# base64 是 Python 标准库，用来把接口返回的图片 Base64 解码成图片文件。
import base64
import httpx
from openai import OpenAI

client = OpenAI(
    api_key="你的密钥",
    base_url="https://moxus.cloud/v1",
    # 直接连接 Moxus AI，不读取系统或终端代理环境变量。
    http_client=httpx.Client(trust_env=False, timeout=60.0),
)

response = client.images.generate(
    model="grok-imagine-image",
    prompt="一张现代办公桌上的智能台灯产品图，白色背景，柔和棚拍光线",
    n=1,
    size="1024x1024",
    response_format="b64_json",
)

# response_format="b64_json" 时，图片内容会在 b64_json 字段里返回。
image_base64 = response.data[0].b64_json

# 把 Base64 图片内容写入本地 PNG 文件。
with open("generated-image.png", "wb") as image_file:
    image_file.write(base64.b64decode(image_base64))

print("图片已保存为 generated-image.png")

import OpenAI from "openai";

// writeFileSync 是 Node.js 标准库方法，用来把图片写到本地文件。
import { writeFileSync } from "node:fs";

const client = new OpenAI({
  apiKey: "你的密钥",
  baseURL: "https://moxus.cloud/v1",
});

const response = await client.images.generate({
  model: "grok-imagine-image",
  prompt: "一张现代办公桌上的智能台灯产品图，白色背景，柔和棚拍光线",
  n: 1,
  size: "1024x1024",
  response_format: "b64_json",
});

// response_format: "b64_json" 时，图片内容会在 b64_json 字段里返回。
const imageBase64 = response.data[0].b64_json;

// Buffer.from(..., "base64") 会把 Base64 字符串还原为图片二进制内容。
writeFileSync("generated-image.png", Buffer.from(imageBase64, "base64"));

console.log("图片已保存为 generated-image.png");