概要

z-image-2api-cfworkは、Gradioベースの画像生成/取得系APIに対してヘッドレスブラウザを使わずにアクセスするためのCloudflare Worker実装です。OpenAIのレスポンス形式に合わせてAPIをラップし、ネイティブのサーバーサイドストリーミング（SSE）に対応。さらに、同時リクエストの錯峰（スロットリング）制御や高度なヘッダ偽装により、フロントエンドの検証や403応答を回避。専用の画像プロキシ機能でホットリンク防止による403を修復し、Cloudflare Workersボタンで簡単デプロイできます。

リポジトリの統計情報

スター数: 3
フォーク数: 0
ウォッチャー数: 3
コミット数: 3
ファイル数: 3
メインの言語: JavaScript

主な特徴

Gradio APIをヘッドレスブラウザ不要で逆向き実装し、サーバーサイドから利用可能にする
OpenAI形式でレスポンスをラップし、既存クライアントとの互換性を確保
並列リクエストの錯峰制御（スロットリング）とネイティブSSEストリーミング対応
高度なリクエスト偽装と専用画像プロキシにより403ホットリンク問題を回避

技術的なポイント

本プロジェクトはCloudflare Workers上で完結する軽量APIゲートウェイ的実装です。worker.js単体でGradio側のエンドポイントに対するリバースプロキシ／ラッパー処理を行い、クライアントが期待するOpenAI形式の入出力へ変換します。ヘッドレスブラウザを使わずに済ませるため、実際のブラウザ検証に依存する箇所はHTTPヘッダ（User-AgentやRefererなど）や挙動再現のためのリクエスト設計で補っています。これによりCookieやフルブラウザ環境が不要になる設計です。

並列制御はCloudflare Workersの環境特性に合わせ、リクエストをその場で制御するスロットリング／キュー機構を実装する方針が取られています（メモリや短命なワーカーインスタンスの制約を考慮）。また、生成系や大きなレスポンスに対してはネイティブのストリーミング（SSE）で逐次送信し、クライアント側で即時描画や部分受信が可能です。画像ホットリンク対策は専用のプロキシ経由で画像を取得・中継し、OriginやReferer制限で403となるケースを回避する実装になっています。

セキュリティ面では、外部サービスへのアクセスにおける偽装ヘッダやレート制御、エラーハンドリング、適切なCORS設定などが考慮されており、Cloudflare Workersのエッジでレスポンスを最適化する構成です。軽量な単一ファイル実装なのでデプロイとカスタマイズが容易で、READMEの「Deploy to Cloudflare Workers」ボタンから即座に導入できます。

プロジェクトの構成

主要なファイルとディレクトリ：

LICENSE: file
README.md: file
worker.js: file

まとめ

Cloudflare Workersで手軽にデプロイできる、Gradio系画像APIの逆向ラッパー兼画像プロキシです。導入が簡単でエッジ処理に最適。

リポジトリ情報：

名前: z-image-2api-cfwork
説明: Gradio API 逆向 (非无头浏览器)、OpenAI 格式封装、并发错峰控制与原生流式 (SSE) 响应、高级请求伪装 (无需 Cookie) 以绕过前端验证、专用图片代理修复 403 防盗链
スター数: 3
言語: JavaScript
URL: https://github.com/lza6/z-image-2api-cfwork
オーナー: lza6
アバター: https://avatars.githubusercontent.com/u/128880206?v=4

README 抜粋:

🎨 z-image-2api (Cloudflare Worker 终极复刻版) v9.0.0

z-image-2api — Cloudflare Worker版：Gradio API逆向と画像プロキシ