接口错误信息留存指南

apiyi GPT Image 2 2k: 400 Bad Request from POST https://api.apiyi.com/v1/images/edits

import time
import requests

BASE_URL = "https://api.apiyi.com/v1"
API_KEY = "sk-your-api-key"          # 生产环境请从环境变量读取


def call_and_log(path, payload, timeout=300):
    started = time.strftime("%Y-%m-%d %H:%M:%S %z")      # 带时区
    try:
        resp = requests.post(
            f"{BASE_URL}{path}",
            headers={"Authorization": f"Bearer {API_KEY}"},
            json=payload,
            timeout=timeout,
        )
    except requests.exceptions.Timeout as exc:
        # 传输层：超时，没有 HTTP 响应可读
        raise RuntimeError(f"[{started}] 请求超时 {timeout}s：{exc!r}") from exc
    except requests.exceptions.RequestException as exc:
        # 传输层：连接重置、SSL 错误、DNS 失败……同样没有响应体
        raise RuntimeError(f"[{started}] 传输层失败：{exc!r}") from exc

    if resp.status_code >= 400:
        # 关键：响应体原样带出，不要在这里改写成自己的措辞
        raise RuntimeError(
            f"[{started}] HTTP {resp.status_code} {path} "
            f"model={payload.get('model')}\n"
            f"x-request-id: {resp.headers.get('x-request-id')}\n"
            f"{resp.text}"
        )
    return resp.json()

from openai import OpenAI, APIStatusError, APIConnectionError

client = OpenAI(
    api_key="sk-your-api-key",
    base_url="https://api.apiyi.com/v1",
    max_retries=3,      # SDK 内建指数退避，针对 429 / 5xx / 连接错误
    timeout=60.0,
)

try:
    resp = client.chat.completions.create(
        model="gpt-5.4",
        messages=[{"role": "user", "content": "Hello"}],
    )
except APIStatusError as e:
    # 服务端返回了 4xx/5xx：状态码、request-id、响应体三样都在这里
    print("HTTP 状态码 :", e.status_code)
    print("request-id  :", e.request_id)
    print("响应体原文  :", e.response.text)
    raise
except APIConnectionError as e:
    # 没拿到 HTTP 响应：连接被重置、超时、本地代理故障
    print("传输层失败  :", repr(e), "|", repr(e.__cause__))
    raise

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'sk-your-api-key',
  baseURL: 'https://api.apiyi.com/v1',
});

try {
  const resp = await client.images.edit({ /* ... */ });
} catch (err) {
  if (err instanceof OpenAI.APIError) {
    // 服务端返回了 4xx/5xx
    console.error('HTTP 状态码 :', err.status);
    console.error('request-id  :', err.requestID);
    console.error('响应体原文  :', JSON.stringify(err.error));
  } else {
    // 传输层：ECONNRESET、UND_ERR_* 等，此时没有 HTTP 响应
    console.error('传输层失败  :', err.code, err.message, err.cause);
  }
  throw err;
}

const resp = await fetch('https://api.apiyi.com/v1/images/edits', {
  method: 'POST',
  headers: { Authorization: 'Bearer sk-your-api-key' },
  body: form,
});

if (!resp.ok) {
  const raw = await resp.text();        // 必须先读 body，再抛错
  throw new Error(
    `HTTP ${resp.status} ${resp.url}\n` +
    `x-request-id: ${resp.headers.get('x-request-id')}\n${raw}`
  );
}

curl -i -sS -X POST https://api.apiyi.com/v1/images/edits \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "model=gpt-image-2" \
  -F "[email protected]" \
  -F "prompt=把背景换成纯白" \
  -w '\n---\nHTTP %{http_code}  耗时 %{time_total}s\n'

上游 HTTP 0：OpenSSL SSL_read: Connection was reset, errno 10054

【问题描述】调用 gpt-image-2 图片编辑接口稳定返回 400
【接口端点】POST https://api.apiyi.com/v1/images/edits
【模型名称】gpt-image-2
【调用时间】2026-08-03 15:44 (UTC+8)
【request-id】从响应头 x-request-id 复制
【HTTP 状态码】400
【响应体原文】
{"error":{"message":"...","type":"...","code":"..."}}
【关键参数】size=2048x2048, quality=high, 参考图 1 张 / 3.2 MB / PNG
【复现情况】连续 5 次调用 5 次失败；换一张参考图后恢复正常
【已排查】Key 有效、余额充足、同一个 Key 调用文本模型正常