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

일반 소개

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를 사용하려면 다음 배포 단계를 완료해야 합니다. 이 과정은 간단하지만 환경을 신중하게 구성해야 합니다.

1. Cloudflare 계정 가입
   공식 Cloudflare 웹사이트를 방문하여 계정을 등록하거나 로그인하세요. 무료 요금제로도 이 프로젝트를 지원하기에 충분합니다. 계정에 Workers AI 및 KV 네임스페이스 권한이 있는지 확인하세요.
2. 프로젝트 코드 복제
   터미널에서 다음 명령을 실행하여 프로젝트를 로컬로 복제합니다:

   git clone https://github.com/justlovemaki/CloudFlare-AI-Image.git
   

   프로젝트 카탈로그로 이동합니다:

   cd CloudFlare-AI-Image
   

3. 랭글러 설치하기
   랭글러는 클라우드플레어 워커를 배포하기 위한 도구입니다. 설치 명령을 실행합니다:

   npm install -g @cloudflare/wrangler
   

   랭글러에 로그인합니다:

   wrangler login
   

   브라우저의 인증 안내에 따라 인증합니다.

4. 환경 변수 구성
   프로젝트는 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 토큰을 입력합니다.

5. 배포 프로젝트
   프로젝트 디렉토리에서 실행합니다:

   wrangler publish
   

   배포에 성공하면 다음과 같은 작업자 URL을 가져옵니다. https://cloudflare-ai-image.your-account.workers.dev.

6. 로컬 테스트
   로컬 디버깅이 필요한 경우 실행합니다:

   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 키를 설정하는 것이 좋습니다.
• 큐 단어 제한민감하거나 부적절한 콘텐츠를 피하기 위해 모델이 자동으로 필터링됩니다.

애플리케이션 시나리오

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

QA

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