상담 그룹에서 자주 듣는 질문들이 있어요. "Coze에서 Nano Banana는 어떻게 설정하나요?", "N8N에 바로 쓸 수 있는 APIYI 노드가 있나요?", "ComfyUI에서 Sora/SeeDance를 연결할 수 있나요?" 이런 질문들은 저희 고객센터에서 가장 많이 언급되는 주제 중 하나입니다.
더 많은 개발자와 콘텐츠 크리에이터가 APIYI(apiyi.com) 플랫폼의 모델 기능을 쉽게 활용할 수 있도록, 저희가 공식적으로 **"APIYI 오픈소스 플러그인 현상 공모 프로젝트"**를 시작합니다! Coze / N8N / ComfyUI 세 가지 주요 워크플로우 생태계를 대상으로 오픈소스 플러그인을 모집하며, 선정된 작품에는 현금 또는 플랫폼 크레딧 보상을 제공합니다. 선정된 모든 작품은 기여자 명의로 APIYI 문서 센터에 등재되어 모든 사용자가 무료로 사용할 수 있게 됩니다.
이미 비슷한 노드, 플러그인, 워크플로우 템플릿을 만들어 보셨거나 직접 구현해보고 싶으셨다면, 이번 글에서 보상 기준, 기술 요구 사항, 제출 절차를 상세히 확인해 보세요. 여러분의 코드를 기다리고 있겠습니다. 많은 참여 부탁드려요!
현상 공모 프로젝트 핵심 정보 요약
이번 현상 공모는 AI 워크플로우와 플러그인 개발에 관심 있는 모든 개발자를 대상으로 하며, 별도의 자격 제한은 없습니다. 작품이 심사를 통과하기만 하면 해당 보상을 받으실 수 있습니다.
대상 플랫폼
현재 APIYI(apiyi.com) 사용자들이 가장 많이 관심을 가지는 세 가지 통합 시나리오입니다.
| 플랫폼 | 사용자 그룹 | 적합한 플러그인 유형 | 우선순위 |
|---|---|---|---|
| Coze (코제) | 노코드 봇 개발자 | 이미지 생성, 비디오 생성, 대화 모델 플러그인 | ⭐⭐⭐⭐⭐ |
| N8N | 자동화 워크플로우 애호가 | 범용 LLM 노드, 배치 처리 노드 | ⭐⭐⭐⭐⭐ |
| ComfyUI | AI 이미지/비디오 크리에이터 | Nano Banana, SeeDance, Sora 노드 | ⭐⭐⭐⭐⭐ |
| Dify | 기업용 지식 베이스 개발자 | 모델 연결 어댑터 | ⭐⭐⭐⭐ |
| FastGPT | 지식 문답 구축 | 대화 모델 플러그인 | ⭐⭐⭐ |
| n8n-nodes-custom | 커뮤니티 노드 마켓 | npm 저장소 배포 | ⭐⭐⭐⭐ |
보상 체계
기여자의 노력을 공정하게 보상하기 위해 두 가지 등급의 보상 기준을 마련했습니다.
| 보상 유형 | 일반 등급 | 프리미엄 등급 | 설명 |
|---|---|---|---|
| 현금 보상 | ¥300 – ¥800 | ¥1000 – ¥3000 | 작품의 완성도와 실용성에 따라 결정 |
| APIYI 크레딧 | ¥500 – ¥1500 | ¥2000 – ¥5000 | 플랫폼 내 사용 가능한 동일 가치 크레딧 |
| 명의 권리 | ✅ 문서 센터 저자 페이지 | ✅ 메인 페이지 추천 + 단독 인터뷰 | 영구 보존 |
| 저작권 | MIT/Apache 2.0 오픈소스 | MIT/Apache 2.0 오픈소스 | 저자 명의권 유지 |
💡 제출 팁: 이미 완성된 작품이 있다면, 본문 하단의 리스트에 맞춰 정리한 후 제출해 주세요. 심사 기간은 영업일 기준 3~5일 소요됩니다. 제출 문의: APIYI(apiyi.com) 공식 홈페이지 하단 "개발자 프로그램" 또는 공식 고객센터 위챗으로 "플러그인 현상 공모"라고 남겨주세요.
Coze 플러그인 개발 방향 및 기술 포인트
Coze(扣子)는 바이트댄스에서 출시한 노코드 AI 봇 개발 플랫폼으로 국내 사용자 기반이 매우 탄탄합니다. 하지만 공식 플러그인 마켓에서 타사 모델을 연동하려면 여전히 API 서비스를 수동으로 설정해야 하는 번거로움이 있습니다. 이에 따라 저희는 다음과 같은 방향의 Coze 플러그인 개발을 장려하고자 합니다.
방향 1: 이미지 생성 플러그인 (최고 보상)
핵심 요구사항은 Coze 봇이 APIYI의 이미지 생성 모델을 직접 호출할 수 있도록 하는 것입니다. 다음 모델들이 포함됩니다:
- Nano Banana 시리즈: Nano Banana, Nano Banana Pro (gemini-3-pro-image)
- GPT-Image 시리즈: gpt-image-1, gpt-image-1-mini
- Flux 시리즈: Flux Pro, Flux Dev, Flux Schnell
- Recraft V3, Ideogram 3, Midjourney v7 등
플러그인 최소 기능 요구사항:
- 텍스트-이미지 변환(Text-to-Image) 지원
- 이미지-이미지 변환(Image-to-Image) 편집 지원
- 해상도 및 비율 파라미터 설정 지원
- Coze 메시지 스트림에서 바로 표시 가능한 이미지 URL 반환
- 사용자 친화적인 오류 메시지 안내
방향 2: 비디오 생성 플러그인
SeeDance, Sora, Kling, Veo 등 비동기 비디오 생성 API를 래핑(Wrapping)하는 플러그인입니다:
| 모델 | API 엔드포인트 | 플러그인 처리 사항 |
|---|---|---|
| SeeDance 2.0 | /videos 비동기 |
작업 제출 + 상태 폴링 |
| Sora 2 | /video/generations |
콜백 모드 지원 |
| Kling 2 | /kling/videos |
다중 해상도 적응 |
| Veo 3 | /google/veo |
영역 라우팅 처리 |
방향 3: 대화 및 도구 호출 플러그인
Claude, GPT, Gemini, DeepSeek 등 다양한 대화 모델을 래핑하여 함수 호출(Function calling), 도구 사용, 스트리밍 출력을 지원합니다.
Coze 플러그인 호출 예제 코드
전형적인 Coze 플러그인 Action 구현(JavaScript):
export async function handler({ input, context }) {
const { prompt, aspect_ratio = "16:9" } = input;
const response = await fetch(
"https://vip.apiyi.com/v1/images/generations",
{
method: "POST",
headers: {
"Authorization": `Bearer ${context.apiyi_key}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
model: "gemini-3-pro-image", // 모델명
prompt: prompt,
n: 1,
size: aspect_ratio === "16:9" ? "1920x1080" : "1024x1024"
})
}
);
const data = await response.json();
return { image_url: data.data[0].url };
}
🎯 기술 팁: Coze 플러그인의 API 키는 하드코딩하지 말고 Coze 자격 증명 변수를 통해 저장하세요. 플러그인 제작자는 README에 APIYI apiyi.com 콘솔에서 전용 키를 발급받는 방법과 호출 한도 예상을 명시하여 사용자가 참고할 수 있도록 하는 것이 좋습니다.
N8N 플러그인 개발 방향 및 기술 포인트
N8N은 오픈소스 자동화 워크플로우 플랫폼으로 국내외 개발자들 사이에서 영향력이 큽니다. 노드 시스템은 TypeScript 기반이며 개발 및 배포가 비교적 표준화되어 있습니다.
N8N 노드 개발의 4가지 형태
| 형태 | 복잡도 | 적용 시나리오 | 예시 |
|---|---|---|---|
| Credential Node | 낮음 | 통합 APIYI 키 인증 | APIYI API Credential |
| Action Node | 중간 | 단일 모델 호출 래핑 | APIYI Image Generation |
| Trigger Node | 높음 | 콜백/Webhook 리스닝 | APIYI Video Job Complete |
| Declarative Node | 낮음 | JSON 기술형 노드 | 빠른 프로토타이핑 |
추천 N8N 노드 기능 목록
플러그인은 최소한 다음 핵심 노드를 포함해야 합니다:
- APIYI Credentials: Base URL, API 키, 프록시 설정 통합 관리
- APIYI Chat Model: GPT/Claude/Gemini/DeepSeek 대화 모델 연동
- APIYI Image Generation: Nano Banana / Flux / GPT-Image 이미지 생성
- APIYI Video Generation: SeeDance/Sora/Kling 비디오 생성(내장 폴링 포함)
- APIYI Batch: OpenAI /v1/batches 배치 처리 작업 관리
- APIYI Embedding: text-embedding-3 등 벡터화 노드
N8N 노드 최소 구현 예시
다음은 N8N 표준을 준수하는 APIYI 이미지 생성 노드 골격(TypeScript)입니다:
import { IExecuteFunctions, INodeType, INodeTypeDescription } from 'n8n-workflow';
export class ApiyiImage implements INodeType {
description: INodeTypeDescription = {
displayName: 'APIYI Image',
name: 'apiyiImage',
group: ['transform'],
version: 1,
credentials: [{ name: 'apiyiApi', required: true }],
properties: [
{ displayName: 'Model', name: 'model', type: 'options',
options: [
{ name: 'Nano Banana Pro', value: 'gemini-3-pro-image' },
{ name: 'GPT Image 1', value: 'gpt-image-1' },
{ name: 'Flux Pro', value: 'flux-pro-1.1' }
], default: 'gemini-3-pro-image' },
{ displayName: 'Prompt', name: 'prompt', type: 'string', default: '' }
]
};
async execute(this: IExecuteFunctions) {
const creds = await this.getCredentials('apiyiApi');
const model = this.getNodeParameter('model', 0) as string;
const prompt = this.getNodeParameter('prompt', 0) as string;
const res = await this.helpers.request({
method: 'POST',
uri: `${creds.baseUrl}/v1/images/generations`,
headers: { Authorization: `Bearer ${creds.apiKey}` },
body: { model, prompt }, json: true
});
return [this.helpers.returnJsonArray([res])];
}
}
⚡ 배포 제안: 우수한 N8N 플러그인은 npm 저장소(명명 규칙
n8n-nodes-apiyi-*)와 GitHub 오픈소스로 동시에 배포하는 것을 권장합니다. APIYI apiyi.com 문서 센터에서 상단에 추천해 드리며, 플러그인 작성자를 위한 독립적인 기여자 페이지도 제공할 예정입니다.
ComfyUI 플러그인 개발 방향 및 기술 포인트
ComfyUI는 이미지/비디오 AI 창작자들 사이에서 가장 활발하게 사용되는 노드 기반 워크플로우 도구입니다. 오픈소스 Python 아키텍처를 기반으로 하며, 강력한 커뮤니티 노드 생태계를 자랑합니다.
ComfyUI 플러그인의 핵심 가치
로컬 모델과 비교했을 때, APIYI의 클라우드 모델을 연동하면 다음과 같은 이점을 누릴 수 있습니다.
- 고성능 로컬 GPU 없이도 가벼운 노트북에서 사용 가능
- Sora 2, SeeDance 2.0, Kling 2 등 로컬 배포가 불가능한 폐쇄형 모델 지원
- VRAM 부담 없이 4K/8K 고해상도 이미지 생성 가능
- 통합 API로 여러 모델을 관리하여 전환 비용 절감
추천 ComfyUI 노드 리스트
| 노드 이름 | 핵심 기능 | 대응되는 로컬 노드 |
|---|---|---|
| APIYI_NanoBananaPro | Google Nano Banana Pro 이미지 생성 | KSampler + SDXL |
| APIYI_GPTImage | OpenAI gpt-image-1 생성/편집 | Flux Dev |
| APIYI_SeeDance | SeeDance 2.0 텍스트/이미지-비디오 변환 | AnimateDiff |
| APIYI_Sora2 | Sora 2 비디오 생성 | – (로컬 대안 없음) |
| APIYI_Kling2 | Kling 2 비디오 생성 | – |
| APIYI_Upscaler | 이미지 업스케일링 (Recraft/Topaz) | Ultimate SD Upscaler |
| APIYI_ChatNode | 대화형 모델 텍스트 노드 | – |
| APIYI_BatchRunner | 배치 작업 실행기 | Batch Image Loader |
ComfyUI 노드 최소 구현 예시
ComfyUI 커스텀 노드는 Python 클래스이며, ComfyUI/custom_nodes/ 디렉토리에 배치하면 바로 로드됩니다.
import requests, os
from PIL import Image
import io, numpy as np, torch
class APIYINanoBananaPro:
@classmethod
def INPUT_TYPES(cls):
return {
"required": {
"prompt": ("STRING", {"multiline": True}),
"aspect_ratio": (["1:1", "16:9", "9:16", "4:3"],),
"api_key": ("STRING", {"default": ""})
}
}
RETURN_TYPES = ("IMAGE",)
FUNCTION = "generate"
CATEGORY = "APIYI/Image"
def generate(self, prompt, aspect_ratio, api_key):
# APIYI API를 통해 이미지 생성 요청
resp = requests.post(
"https://vip.apiyi.com/v1/images/generations",
headers={"Authorization": f"Bearer {api_key}"},
json={"model": "gemini-3-pro-image",
"prompt": prompt, "size": aspect_ratio}
)
url = resp.json()["data"][0]["url"]
img_bytes = requests.get(url).content
img = Image.open(io.BytesIO(img_bytes)).convert("RGB")
arr = np.array(img).astype(np.float32) / 255.0
return (torch.from_numpy(arr)[None,],)
NODE_CLASS_MAPPINGS = {"APIYI_NanoBananaPro": APIYINanoBananaPro}
NODE_DISPLAY_NAME_MAPPINGS = {"APIYI_NanoBananaPro": "APIYI Nano Banana Pro"}
투고 표준 및 심사 기준
우수한 작품이 선정될 수 있도록 명확한 심사 기준을 마련했습니다. 투고 전 아래 내용을 확인해 주세요.
필수 기본 요건
- 오픈소스 라이선스: MIT / Apache 2.0 / GPL v3 중 하나
- 코드 저장소: GitHub / GitLab / Gitee 공개 저장소
- 문서 완성도: README에 설치, 설정, 사용 예시 포함
- 테스트 가능: 최소 1개 이상의 실행 가능한 데모 제공
- APIYI 호환성: APIYI apiyi.com 표준 base_url 및 키 인증 사용
프리미엄 등급 추가 요건
¥3000 / ¥5000 상금을 목표로 한다면 다음 요건을 추가로 충족해야 합니다.
- 다중 모델 커버리지 (주요 모델 5개 이상)
- 완벽한 에러 처리 (타임아웃, 속도 제한, 파라미터 오류 등)
- 영문/중문 이중 언어 README
- 3개 이상의 워크플로우 예시 템플릿 포함
- 3-5분 분량의 사용 가이드 영상
가점 항목
- 특정 플랫폼(예: Dify, FastGPT)을 지원하는 최초의 플러그인
- 간결하고 유지보수가 쉬운 코드 (단일 파일 500줄 이하)
- 지속적인 업데이트 계획
- 커뮤니티 사용 활성화 (GitHub star 20개 이상)
현상 공모 FAQ
Q1: 이미 유사한 플러그인을 개발했는데, 바로 신청해도 되나요?
물론입니다. 가장 환영하는 방식입니다. 플러그인이 '기본 요구 사항'을 충족하고 APIYI(apiyi.com)의 base_url 및 키 규격에 맞게 조정(약간의 수정이 필요할 수 있음)되어 있다면 바로 심사를 제출할 수 있습니다. 완성도가 높은 기존 GitHub 프로젝트는 보통 바로 우수 등급으로 선정됩니다. 제출 시 저장소 링크와 간단한 자가 점검표를 첨부해 주시면, 3영업일 이내에 1차 피드백을 드립니다.
Q2: 현금 보상과 APIYI 크레딧을 동시에 선택할 수 있나요?
비율을 섞어서 선택할 수 있습니다. 예를 들어 우수 등급 보상이 3,000위안일 경우, 현금 1,500위안 + 플랫폼 크레딧 1,500위안으로 조합하거나, 전액을 크레딧으로 전환(전환 비율 1:1.3, 즉 3,000위안 현금 보상을 3,900위안 크레딧으로 전환)할 수 있습니다. 구체적인 사항은 투고 승인 후 APIYI(apiyi.com) 운영진과 협의하여 선호하시는 방식으로 지급해 드립니다.
Q3: 플러그인을 오픈 소스로 공개하면 저작권은 어떻게 되나요?
저작권과 성명권은 모두 개발자님께 있습니다. APIYI는 비독점적 사용권과 문서 센터 내 전시 권한만을 요청합니다. 개발자님은 계속해서 작품을 유지 보수, 배포 및 상용화할 수 있으며, 이를 바탕으로 오픈 소스 커뮤니티에서 명성을 쌓으시는 것을 적극 권장합니다. 이후 추가적인 협업이 필요하시면 언제든 논의 가능합니다.
Q4: 한 사람이 여러 작품을 제출할 수 있나요? 제한이 있나요?
제한 없습니다. 동일한 기여자가 Coze, N8N, ComfyUI 세 플랫폼에 각각 작품을 제출할 수 있으며, 각 작품별로 별도 심사 및 보상이 지급됩니다. 한 기여자가 "세 플랫폼용 플러그인 세트"를 한 번에 투고하여 3개의 우수 등급 보상을 모두 받은 사례도 있습니다. 이러한 시스템적인 기여는 매우 환영합니다.
Q5: 여러 명이 동시에 같은 유형의 플러그인을 제출하면 어떻게 평가하나요?
"완성도가 높은 순서"와 "기능 커버리지 범위"라는 두 가지 기준으로 심사합니다. 나중에 제출된 작품이라도 기능 범위나 코드 품질이 월등히 뛰어나다면 선정되어 전체 보상을 받을 수 있습니다. 선정된 두 작품은 문서 센터에 동시에 게시되어 사용자가 자유롭게 선택할 수 있으며, '독점' 개념은 존재하지 않습니다.
Q6: 투고 후 피드백까지 얼마나 걸리나요?
표준 절차: 3영업일 이내에 1차 심사 및 피드백 완료, 승인 후 5영업일 이내에 보상 지급. 우수 등급의 경우 추가적인 코드 감사 및 문서 확인 절차가 있을 수 있으나, 전체 기간은 10영업일을 넘지 않습니다. 이메일과 위챗(WeChat)을 통해 진행 상황을 신속하게 공유해 드립니다.
투고 절차 및 연락처
표준 투고 경로
작품을 준비하신 후 다음 단계에 따라 제출해 주세요:
- 저장소 정리: GitHub/Gitee 저장소가 공개 상태인지, README가 완벽한지, 데모가 실행 가능한지 확인합니다.
- 투고 양식 작성: APIYI(apiyi.com) 접속 → 문서 센터 → "개발자 프로그램" 페이지에서 투고 양식을 작성합니다.
- 자료 제공: 저장소 링크, 플러그인 소개, 선호하는 보상 형태, 연락처를 기재합니다.
- 심사 대기: 3영업일 이내에 1차 피드백을 받습니다.
- 수정 및 확정: 피드백에 따라 수정(필요 시) 후 최종 선정됩니다.
- 보상 지급: 현금은 법인/개인 계좌로 지급되며, 크레딧은 APIYI 계정으로 자동 충전됩니다.
- 문서 게시: 작품이 APIYI 문서 센터 기여자 섹션에 게시되며, 개발자님의 성명과 연락처가 표기됩니다.
빠른 연락 채널
- APIYI 공식 홈페이지: apiyi.com 하단 "개발자 프로그램" 메뉴
- 공식 고객센터 위챗: APIYI 공식 계정 팔로우 → 메뉴 "고객센터 문의" → "플러그인 현상 공모"라고 메모
- 이메일 투고: APIYI(apiyi.com) 문서 센터에 공개된 개발자 이메일로 발송
흔한 오해 바로잡기
오해 1: "전문 프로그래머만 참여할 수 있다?"
전혀 그렇지 않습니다. Coze의 플러그인 개발은 사실 JSON 설정과 약간의 스크립트 위주로 진행되기에 노코드 개발자분들도 충분히 완성할 수 있습니다. N8N의 Declarative Node 역시 깊은 TypeScript 경험이 필요하지 않죠. 작동하는 결과물을 만들어본 경험이 있다면 누구든 환영합니다.
오해 2: "완벽하게 만들어야만 제출할 수 있다?"
아닙니다. 완성도는 작은 것부터 점진적으로 개선해 나가는 것입니다. '단일 모델, 단일 기능'을 갖춘 최소 기능 제품(MVP) 형태의 플러그인이라도 괜찮습니다. 코드가 깔끔하고 잘 작동하며 사용자에게 가치를 제공한다면 표준 등급의 보상을 받을 수 있습니다. 우수 등급은 더 체계적인 기여를 장려하기 위한 것이지, 결코 진입 장벽이 아닙니다.
오해 3: "비주류 플랫폼은 할 가치가 없다?"
오히려 그 반대입니다. Dify, FastGPT, LangFlow 등 희소성 있는 플랫폼을 지원하는 첫 번째 플러그인은 심사 시 가산점이 부여되며, 우수 등급으로 선정될 확률이 높습니다. 이미 이러한 플랫폼에서 깊이 있게 활동하고 계셨다면, 이번 현상 공모는 그동안의 노하우를 수익화할 좋은 기회입니다.
요약
이번 오픈소스 플러그인 현상 공모 프로젝트는 본질적으로 저희가 커뮤니티와 함께 **APIYI(apiyi.com)의 모델 성능을 '도구화 및 생태계화'**하고자 하는 목표를 담고 있습니다. Coze에서 봇을 만들거나, N8N으로 워크플로우를 구성하거나, ComfyUI에서 이미지 생성을 즐기는 모든 개발자가 Nano Banana, Sora, SeeDance, GPT, Claude와 같은 최첨단 모델을 가장 쉽게 활용할 수 있도록 돕는 것이죠.
이미 만들어둔 작품이 있다면 이번 기회에 코드를 수익화해보세요. 만약 아이디어는 있지만 아직 시작하지 않았다면, 이번 공모전은 오픈소스 프로젝트를 시작하고 개인 기술 브랜딩을 쌓을 수 있는 이상적인 기회입니다. APIYI(apiyi.com)에 많은 투고 부탁드리며, 주변의 관심 있는 분들께도 이 소식을 널리 공유해 주세요.
"사용자는 계속 묻고, 고객센터는 반복해서 답하는" 비효율적인 문제들을 우리 함께 커뮤니티 전체가 공유하는 오픈소스 자산으로 바꿔봅시다.
📌 작성자: 본 게시물은 APIYI(apiyi.com) 운영팀에서 작성하였으며, APIYI 커뮤니티의 2026 오픈소스 플러그인 현상 공모 프로젝트 시작을 알립니다. 투고 채널은 상시 열려 있으며, 보상 기준은 장기적으로 유효하니 지속적인 관심 부탁드립니다.
