Cloudflare Worker 기반 AI 이미지 생성 스크립트

1.4K 00

일반 소개

CloudFlare-AI-Image는 GitHub에서 호스팅되는 오픈 소스 프로젝트로, Cloudflare Workers 플랫폼을 통해 무료 AI 이미지 생성 서비스를 제공합니다. 다음과 같은 5가지 모델을 기반으로 텍스트 생성 및 그래프 생성 기능을 지원합니다. 플럭스.1 [빠른], 안정적인 확산 XL 등 SD-XL-Base-CF가 기본으로 사용됩니다. 사용자는 텍스트 설명을 입력하거나 참조 이미지를 업로드하여 고품질 이미지를 생성할 수 있습니다. 프로젝트 인터페이스는 OpenAI 형식과 호환되므로 개발자, 디자이너, 크리에이티브 애호가들이 쉽게 통합하고 간단하게 배포할 수 있습니다. Cloudflare의 글로벌 네트워크를 통해 생성 속도가 빠르고 안정적이며, 코드는 오픈 소스이므로 자유롭게 수정할 수 있습니다.

기능 목록

텍스트 생성 이미지를 지원하고, 텍스트 설명을 입력하여 고품질 이미지를 생성할 수 있습니다.
업로드된 참조 이미지를 기반으로 새 이미지를 생성하는 그래프 생성 이미지를 지원합니다.
5가지 옵션 모델이 제공됩니다: DS-8-CF, SD-XL-Bash-CF, SD-XL-Lightning-CF, FLUX.1-Schnell-CF, SF-Kolors.
타사 애플리케이션에 쉽게 통합할 수 있도록 OpenAI 형식과 호환되는 REST API를 제공합니다.
이미지 스타일, 단계 수 및 해상도와 같은 생성 매개변수를 사용자 지정할 수 있습니다.
Cloudflare Workers에 배포하면 관리형 서버가 필요하지 않습니다.
생성된 이미지 캐싱을 위한 KV 스토리지를 지원합니다.
오픈 소스 코드, 사용자 수정 및 확장 가능.

도움말 사용

설치 프로세스

CloudFlare-AI-Image를 사용하려면 다음 배포 단계를 완료해야 합니다. 이 과정은 간단하지만 환경을 신중하게 구성해야 합니다.

Cloudflare 계정 가입
공식 Cloudflare 웹사이트를 방문하여 계정을 등록하거나 로그인하세요. 무료 요금제로도 이 프로젝트를 지원하기에 충분합니다. 계정에 Workers AI 및 KV 네임스페이스 권한이 있는지 확인하세요.
프로젝트 코드 복제
터미널에서 다음 명령을 실행하여 프로젝트를 로컬로 복제합니다:
```
git clone https://github.com/justlovemaki/CloudFlare-AI-Image.git
```
프로젝트 카탈로그로 이동합니다:
```
cd CloudFlare-AI-Image
```
랭글러 설치하기
랭글러는 클라우드플레어 워커를 배포하기 위한 도구입니다. 설치 명령을 실행합니다:
```
npm install -g @cloudflare/wrangler
```
랭글러에 로그인합니다:
```
wrangler login
```
브라우저의 인증 안내에 따라 인증합니다.
환경 변수 구성
프로젝트는 Workers AI 및 KV 네임스페이스를 바인딩하고 계정 정보를 구성해야 합니다.
- Cloudflare 대시보드에 로그인하고 계정 ID를 찾습니다.
- 작업자 AI, 작업자 스크립트 편집 및 KV 스토리지를 포함할 수 있는 권한이 있는 API 토큰을 생성합니다.
- 컴파일러 wrangler.toml 파일에 계정 ID와 KV 네임스페이스를 추가합니다:
```
account_id = "你的账户ID"
name = "cloudflare-ai-image"
compatibility_date = "2023-09-01"
[[kv_namespaces]]
binding = "IMAGE_KV"
id = "你的KV命名空间ID"
```
- KV 네임스페이스를 만듭니다:
```
wrangler kv:namespace create IMAGE_KV
```
  반환된 ID를 복사하여 wrangler.toml.
- API 토큰을 설정합니다:
```
wrangler secret put CLOUDFLARE_API_TOKEN
```
  API 토큰을 입력합니다.
- (선택 사항) 실리콘 기반 플로우 스테이지 모델을 사용하는 경우 SF_TOKEN을 설정합니다:
```
wrangler secret put SF_TOKEN
```
  실리콘 모빌리티 플랫폼에서 요청한 API 토큰을 입력합니다.
배포 프로젝트
프로젝트 디렉토리에서 실행합니다:
```
wrangler publish
```
배포에 성공하면 다음과 같은 작업자 URL을 가져옵니다. https://cloudflare-ai-image.your-account.workers.dev.
로컬 테스트
로컬 디버깅이 필요한 경우 실행합니다:
```
wrangler dev
```
이렇게 하면 로컬 서버가 시작되고 http://localhost:8787 테스트 기능.

사용법

배포가 완료되면 API, 클라이언트 또는 작업자 URL을 통해 이미지 생성을 사용할 수 있습니다. 다음은 이를 위한 자세한 지침입니다.

모델 선택

이 프로젝트는 5가지 모델을 지원하며, 최상의 결과를 얻으려면 FLUX.1-Schnell-CF를 권장하지만 일일 사용량 제한이 있습니다. 다른 모델은 아래에 나열되어 있습니다:

DS-8-CF드림쉐이퍼-8-LCM을 기반으로 아트 스타일의 이미지를 빠르게 생성하는 데 적합합니다.
SD-XL-Bash-CF기본 모델, 속도와 품질이 균형을 이루는 Stable Diffusion XL 기반.
SD-XL-Lightning-CF간단한 시나리오에 맞게 속도를 최적화합니다.
FLUX.1-Schnell-CF고품질 모델, 디테일이 풍부하여 복잡한 장면에 권장됩니다.
SF-컬러아시아 스타일 이미지에 적합한 콰이 색상을 기반으로 SF_TOKEN을 구성해야 합니다.

모델을 선택할 때 API 요청 또는 구성 파일에 모델 이름을 지정합니다(예: 다음과 같이). "model": "@cf/black-forest-labs/flux-1-schnell".

빈센느 다이어그램

벤 다이어그램은 텍스트 설명에서 이미지를 생성합니다.

API를 통해::
POST 요청을 사용하여 API 엔드포인트를 호출합니다:

curl -X POST https://your-project.workers.dev/api/generate \
-H "Content-Type: application/json" \
-d '{"prompt": "一片星空下的雪山，月光照耀", "model": "@cf/black-forest-labs/flux-1-schnell", "steps": 8}'

이미지 URL 또는 Base64 데이터가 포함된 JSON을 반환합니다.

클라이언트를 통해::
프로젝트 인터페이스는 OpenAI 형식과 호환되며 다음과 같은 OpenAI 지원 클라이언트에서 사용할 수 있습니다. ChatGPT (클라이언트)를 클릭합니다. 클라이언트의 API 주소를 작업자 URL로 구성하고 이미지 생성 프롬프트를 입력합니다.
작업자 URL을 통해::
인터뷰 https://your-project.workers.dev를 클릭하고 프롬프트 단어를 입력한 후 생성을 클릭하면 브라우저에 이미지가 표시됩니다.

프롬프트 단어 최적화::
명확한 단서 단어는 이미지 품질을 향상시킵니다. 예시:

퍼지:"一朵花"
최적화:"一朵盛开的红玫瑰，背景是绿色草地，阳光明媚"
다음과 같은 영어 단서가 더 효과적일 수 있습니다. "A red rose in bloom on a green meadow under bright sunlight".

투손(도시)

튜플은 참조 이미지를 기반으로 새 이미지를 생성합니다.

API를 통해::
이미지를 업로드하고 힌트 단어를 입력합니다:

curl -X POST https://your-project.workers.dev/api/generate \
-H "Content-Type: application/json" \
-d '{"prompt": "将这张图片变成卡通风格", "image": "base64编码的图像数据", "model": "@cf/stabilityai/stable-diffusion-xl-base-1.0"}'

작업자 URL을 통해::
페이지를 방문하여 참조 이미지를 업로드하고 설명을 입력합니다(예 "卡通风格")를 클릭하여 새 이미지를 생성합니다.

사용자 지정 매개변수

다음 매개변수 조정이 지원됩니다:

단계기본값 8, 범위 1~50, 단계가 높을수록 더 자세한 정보를 제공하지만 시간 소모가 증가합니다.
(사진의) 해상도기본 512x512, 1024x1024로 조정 가능(지원 모델에 따라 다름).
헤어스타일다음과 같은 큐 단어로 제어 "油画风格"및"赛博朋克".
API 요청에 매개변수를 추가합니다:

{
"prompt": " futuristic city at night",
"steps": 12,
"width": 1024,
"height": 1024
}

강제 번역 옵션

--ntl다국어 사용자를 위해 번역을 비활성화하고 원래 프롬프트 단어를 유지합니다.
--tl프롬프트 단어를 영어로 강제 번역하여 생성 품질을 개선합니다.
API 요청에 "translate": "tl" 어쩌면 "translate": "ntl".

로그 보기

Cloudflare 대시보드에 로그인하고 작업자 개요로 이동하여 요청 로그, 생성 로그 및 리소스 사용량을 확인합니다.KV 네임스페이스는 이미지를 캐시하여 중복 생성을 줄입니다.

주의

무료 할당량개인 사용에는 하루 100,000건의 요청을 지원하는 Cloudflare Workers 무료 요금제로 충분합니다. Workers AI의 모델 호출에는 추가 제한이 있을 수 있습니다(예: FLUX.1의 일일 제한).
모델 성능FLUX.1-Schnell-CF는 가장 잘 작동하지만 높은 부하에서는 제한될 수 있으며, SD-XL-Bash-CF는 매일 사용하기에 적합합니다.
안전무단 액세스를 방지하기 위해 API 키를 설정하는 것이 좋습니다.
큐 단어 제한민감하거나 부적절한 콘텐츠를 피하기 위해 모델이 자동으로 필터링됩니다.

애플리케이션 시나리오

콘텐츠 제작
블로거는 게시물을 설명하기 위해 다음을 입력해야 합니다. "一片热带雨林，阳光穿透树叶"최신 버전의 디자인은 몇 초 만에 고품질 이미지를 생성하여 디자인 비용을 절감할 수 있는 디자인입니다.
애플리케이션 개발
개발자는 API를 통해 동적으로 호출되는 이커머스 플랫폼용 제품 디스플레이 맵을 생성하고 다음과 같은 설명을 입력합니다. "现代风格的沙发，白色背景"를 사용하여 사용자 경험을 향상시킬 수 있습니다.
아트 디스커버리
학생 또는 아티스트가 스케치를 업로드하고 다이어그램 생성 기능을 사용한 후 "赛博朋克风格"를 사용하여 학습 또는 프레젠테이션을 위한 독특한 작품을 만들 수 있습니다.
교육 및 훈련
교사는 입력과 같은 교육 자료를 생성합니다. "古代中国的城市街道"를 사용하여 역사 강좌에서 장면을 시각화합니다.

QA

이미지를 생성하는 데 시간이 얼마나 걸리나요?
모델, 단계 수, 네트워크에 따라 2~15초. flux.1-schnell-cf가 가장 빠르고, sd-xl-bash-cf가 약간 느립니다.
어떤 이미지 유형이 지원되나요?
풍경, 사람, 사물, 아트 스타일 등을 지원합니다. 복잡한 장면은 단서 단어에 맞게 최적화해야 하며 민감한 콘텐츠는 필터링됩니다.
배포 비용을 지불해야 하나요?
필요하지 않습니다. 이 프로젝트는 오픈 소스이며 Cloudflare 무료 요금제로 충분합니다.SF-Kolors 모델에는 무료 SF_TOKEN 애플리케이션이 필요합니다.
모델을 변경하려면 어떻게 하나요?
API 요청에 모델 이름을 지정하거나 구성 파일에서 기본 모델을 수정합니다. FLUX.1-Schnell-CF를 테스트하는 것이 좋습니다.
투펠로 기능은 어떻게 작동하나요?
참조 이미지를 업로드하고 설명을 입력합니다(예 "卡通风格"), API 또는 페이지를 통해 새 이미지를 생성합니다.