개요
플러그인hellojint/updream-openai-compatible-plugin(GitHub)은 Updream Desktop v0.2.0을 위한 오픈 소스 이미지 생성 플러그인으로, 범용 OpenAI 호환 이미지 프로토콜을 사용합니다. 설치하면 데스크톱 클라이언트가 OpenAI Images 인터페이스를 준수하는 모든 서드파티 API 업스트림으로 이미지 생성 요청을 전달합니다. API 경로에서 APIYI는 이 요구 사항을 충족합니다.
프로젝트 정보
- 소스:
github.com/hellojint/updream-openai-compatible-plugin(GitHub) - 라이선스: MIT
- 작성자: hellojint
- 플러그인 패키지 이름:
updream-openai-compatible-v1.updplugin - 기반: 공식 Updream 플러그인 제작 가이드의 OpenAI 이미지 제공자 예제
핵심 기능
범용 OpenAI 호환 프로토콜
/v1/images/generations를 노출하고 Bearer로 인증하는 모든 상위 서비스와 함께 작동합니다. APIYI가 이를 충족합니다.데스크톱에서 로컬 실행
작업은 Updream Desktop v0.2.0에서 로컬로 실행되고 결과를 웹 캔버스로 반환합니다.
API 키 로컬 저장
키는 Updream 시스템 키체인에 보관되고 런타임에 읽습니다. 플러그인 자체에는 자격 증명이 포함되어 있지 않습니다.
여러 제공업체를 나란히 사용
데스크톱 클라이언트에서 여러 제공업체(예:
openai, apiyi-compatible)를 저장하고 이들 사이를 전환할 수 있습니다.크기 자동 매핑
데스크톱 선명도와 가로세로 비율을 상위 서비스의
size 매개변수에 자동으로 매핑합니다. 하드 코딩된 extra.size가 매핑보다 우선합니다.여러 응답 형식
data[].url, data[].b64_json, 최상위 url 등을 지원합니다. MIME은 Base64에서 추론합니다.APIYI 모델 예시
다음 ID를 엔드포인트 ID 필드에 입력할 수 있습니다. 예시일 뿐입니다.실제로 지원되는 모델은 APIYI 모델 권장 사항 페이지에 나와 있습니다. 이 표는 플러그인이 허용하는 필드 형식만 보여 줍니다.
플러그인 구성 필드
플러그인이 데스크톱 클라이언트에 로드되면 API 키 추가 양식에 다음 항목이 표시됩니다.
API 키는 민감한 정보입니다. 실제 키를 스크린샷, 문서, 이슈, README 파일 또는 채팅에 붙여 넣지 마십시오. APIYI 콘솔에서 데스크톱 클라이언트 전용 사용량 한도가 설정된 키를 생성하고, 사용이 끝나면 해당 키를 폐기하십시오.
설치 및 구성(단계별 안내)
0단계: 데스크톱 클라이언트 개요
v0.2.0로 구성됩니다.
1단계: 플러그인 가져오기
updream-openai-compatible-v1.updplugin을 선택하고, 요청되면 설치를 확인합니다. 작성자는 확인하기 전에 plugin.py을 검토할 것을 권장합니다.
2단계: 설치 확인
3단계: 키 추가
4단계: APIYI 구성
연결 테스트와 생성 테스트를 클릭합니다. 연결에 성공했습니다! API를 사용할 수 있습니다가 표시되면 구성을 저장합니다.
5단계: 공급자 활성화 확인
apiyi-compatible 항목이 표시됩니다. 공급자 식별자는 plugin:universal-openai-compatible-image이며 상태는 활성화됨입니다. 언제든지 공급자를 전환하거나 비활성화할 수 있습니다.
사용법: 웹 → 데스크톱 → 웹 루프
위의 다섯 단계를 완료한 후 Updream 웹 클라이언트에서 이미지 생성을 실행하면 데스크톱 측의apiyi-compatible 제공업체를 사용하고, 이를 https://api.apiyi.com/v1/images/generations로 전달합니다. 결과는 웹 캔버스 노드로 다시 전송됩니다.
apiyi-compatible(화살표 위치) + 16:9 / 2K / ×1가 표시됩니다. 이는 Updream 웹 클라이언트에서 시작되어 데스크톱 클라이언트에서 실행된 후 웹 캔버스로 반환된 작업의 결과가 표시된 것입니다.
자주 묻는 질문
데스크톱 클라이언트에 ‘플러그인 가져오기’ 버튼이 표시되지 않습니까?
데스크톱 클라이언트에 ‘플러그인 가져오기’ 버튼이 표시되지 않습니까?
데스크톱 클라이언트 버전이 ≥ v0.2.0인지 확인합니다. 이전 버전에는 플러그인 지원이 없으므로 먼저 Updream Desktop을 업그레이드해야 합니다.
플러그인을 가져온 후 프로토콜 드롭다운에 ‘범용 OpenAI 호환 이미지’가 표시되지 않습니까?
플러그인을 가져온 후 프로토콜 드롭다운에 ‘범용 OpenAI 호환 이미지’가 표시되지 않습니까?
.updplugin아카이브의 루트에plugin.py이 직접 포함되어 있으며manifest.entry과 일치하는지 확인합니다.- 데스크톱 클라이언트를 다시 시작합니다.
- 플러그인 관리 페이지에서 플러그인 상태가 비활성화됨이 아닌지 확인합니다.
연결 테스트는 성공하지만 생성에 실패합니까?
연결 테스트는 성공하지만 생성에 실패합니까?
- 엔드포인트 ID의 철자가 올바르고 APIYI의 현재 모델 목록에 포함되어 있는지 확인합니다.
- 계정 잔액이 충분한지 확인합니다(잔액이 남아 있는데도 계정에서 실패하는 이유는 무엇입니까? 참조).
- 데스크톱 클라이언트의 로컬 실행 페이지에서 정확한 오류 코드를 확인합니다.
데스크톱 클라이언트에서는 작동하지만 웹 클라이언트에서는 동일한 공급자를 사용할 수 없는 이유는 무엇입니까?
데스크톱 클라이언트에서는 작동하지만 웹 클라이언트에서는 동일한 공급자를 사용할 수 없는 이유는 무엇입니까?
웹 클라이언트는 이 플러그인을 거치지 않습니다. OpenAI 호환 프로토콜 구성과 함께 웹 클라이언트의 외부 모델 커넥터 스킬을 사용하거나 Updream와 APIYI 통합(웹)을 참조합니다.
플러그인을 다시 패키징하려면 어떻게 해야 합니까?
플러그인을 다시 패키징하려면 어떻게 해야 합니까?
manifest.json.version의 버전을 올린 후 다시 패키징합니다.plugin.py이 직접 포함되어 있어야 합니다.API 키가 플러그인 코드나 로그에 포함됩니까?
API 키가 플러그인 코드나 로그에 포함됩니까?
아니요. 플러그인에는 자격 증명이 포함되어 있지 않습니다. 키는 Updream 키체인에 저장되며 런타임에
cfg.get('api_key')을 통해 읽습니다. 실제 키를 plugin.py, README, 이슈 또는 채팅에 붙여 넣지 마십시오.관련 리소스
APIYI와 Updream 통합(웹, 권장)
웹 클라이언트는 외부 모델 커넥터 스킬을 통해 APIYI에 연결되며 플러그인이 필요하지 않습니다
hellojint/updream-openai-compatible-plugin
이 문서의 기반이 되는 오픈 소스 저장소(MIT 라이선스)입니다:
github.com/hellojint/updream-openai-compatible-pluginAPIYI 모델 추천
현재 APIYI에서 지원하는 이미지 모델과 요금을 확인합니다
APIYI API 키 관리
API 키 생성 및 관리 모범 사례
APIYI 콘솔
전용 키를 생성하고, 사용량을 확인하며, 잔액 한도를 설정합니다
APIYI 통합 및 사용
API 통합 및 OpenAI 호환 프로토콜 개요