개요
플러그인hellojint/updream-openai-compatible-plugin (GitHub)은 범용 OpenAI 호환 Image 프로토콜을 지원하는 Updream Desktop v0.2.0용 오픈소스 이미지 생성 플러그인입니다. 설치 후 데스크톱 클라이언트는 OpenAI Images 인터페이스를 준수하는 모든 서드파티 업스트림 API로 이미지 생성 요청을 전달합니다. APIYI는 API 경로에서 이 요구사항을 충족합니다.
프로젝트 정보
- 소스:
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이며 상태는 활성화됨입니다. 언제든지 프로바이더를 전환하거나 비활성화할 수 있습니다.
사용법: Web → Desktop → Web 루프
위의 5단계를 거친 후, Updream 웹 클라이언트에서 이미지 생성을 실행하면 데스크톱 측의apiyi-compatible Provider를 사용하여 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, 이슈 또는 채팅에 실제 키를 붙여넣지 마십시오.관련 리소스
Updream과 APIYI 연동 (웹, 권장)
웹 클라이언트는 External Model Connector 스킬을 통해 APIYI에 연결됩니다 — 플러그인이 필요하지 않습니다
hellojint/updream-openai-compatible-plugin
본 문서의 기반이 된 오픈소스 저장소(MIT 라이선스):
github.com/hellojint/updream-openai-compatible-pluginAPIYI 모델 추천
현재 APIYI에서 지원하는 이미지 모델 및 가격을 확인하실 수 있습니다
APIYI API 키 관리
API 키 생성 및 관리를 위한 모범 사례입니다
APIYI 콘솔
전용 키를 생성하고 사용량을 확인하며 잔액 한도를 설정할 수 있습니다
APIYI 연동 및 사용법
API 연동 및 OpenAI 호환 프로토콜 개요입니다