ユーザーから相談グループで、**「CozeでNano Bananaを調整するにはどうすればいい？」「N8NにAPIYIの公式ノードはある？」」「ComfyUIでSoraやSeeDanceを使いたい！」**といった質問が頻繁に寄せられています。これらは、私たちがサービスデスクで最も多くメンションされる話題です。
より多くの開発者やコンテンツクリエイターが、APIYI（apiyi.com）プラットフォームのモデル機能を気軽に活用できるよう、**「APIYIオープンソースプラグイン懸賞プログラム」**を正式に開始します。Coze / N8N / ComfyUI の3大ワークフローエコシステムに向けたオープンソースプラグインを募集し、現金またはプラットフォーム利用クレジットの報酬を提供します。採用された作品はすべて、貢献者名義でAPIYIドキュメントセンターに掲載され、全ユーザーが無料で利用できるようになります。
もし、これまでに似たようなノード、プラグイン、ワークフローテンプレートを作成したことがある方、あるいはこれから実装してみたいと考えている方は、この記事で報酬基準、技術要件、応募手順を確認してください。コードを持って「参考コード（抄作業）」を書きに来てくださる方、あるいは懸賞を狙いたい方、大歓迎です！
懸賞プログラムの概要
今回の懸賞は、AIワークフローやプラグイン開発に興味のあるすべての開発者が対象です。**参加のハードルや属性制限はありません。**作品が審査を通過すれば、報酬を獲得できます。
懸賞対象プラットフォーム
現在、APIYI（apiyi.com）で最もユーザーの注目を集めている3大統合シナリオは以下の通りです：
| プラットフォーム | ユーザー層 | 推奨されるプラグインタイプ | 懸賞優先度 |
|---|---|---|---|
| Coze | ノーコードBot開発者 | 画像生成、動画生成、会話モデルプラグイン | ⭐⭐⭐⭐⭐ |
| N8N | 自動化ワークフロー愛好家 | 汎用LLMノード、バッチ処理ノード | ⭐⭐⭐⭐⭐ |
| ComfyUI | AI画像・動画クリエイター | Nano Banana、SeeDance、Soraノード | ⭐⭐⭐⭐⭐ |
| Dify | 企業向けナレッジベース開発者 | モデル統合アダプター | ⭐⭐⭐⭐ |
| FastGPT | Q&A構築 | 会話モデルプラグイン | ⭐⭐⭐ |
| n8n-nodes-custom | コミュニティノード市場 | npmリポジトリへの公開 | ⭐⭐⭐⭐ |
報酬メカニズム
貢献者の時間と労力に公正に報いるため、2段階の報酬基準を設けています：
| 報酬タイプ | 標準クラス | プレミアムクラス | 備考 |
|---|---|---|---|
| 現金報酬 | 300 – 800元 | 1000 – 3000元 | 作品の完成度と実用性に応じて決定 |
| APIYI利用枠 | 500 – 1500元 | 2000 – 5000元 | 同額のプラットフォーム利用クレジット |
| 貢献者権利 | ✅ ドキュメントセンター掲載 | ✅ ホームページ推奨枠 + インタビュー | 永続的に保持 |
| 著作権 | MIT/Apache 2.0 オープンソース | MIT/Apache 2.0 オープンソース | 作者が署名権を保持 |
💡 投稿のアドバイス：もし既に完成した作品がある場合は、本記事末尾のリストに従って整理し提出するだけです。審査期間は3〜5営業日です。投稿窓口：APIYI公式サイト（apiyi.com）フッターの「開発者プログラム」、または公式カスタマーサポートのWeChatを友だち追加して「プラグイン懸賞」とメモをお送りください。
title: Coze および N8N プラグイン開発の指針と技術的要点
description: Coze および N8N 向けに、APIYI モデルを活用したプラグインを開発するための技術的な指針と要点を解説します。画像生成から対話モデルまで、効率的な実装方法を網羅しています。
Coze プラグイン開発の方向性と技術要点
Coze (扣子) は、ByteDance が提供するノーコード AI Bot 開発プラットフォームです。中国国内で多くのユーザーを抱えていますが、公式プラグインマーケットでサードパーティ製のモデルを接続するには、依然として API サービスを手動で設定する必要があります。今回募集する Coze プラグインは、以下の方向性をカバーすることを想定しています。
方向性 1：画像生成プラグイン（最高賞金）
核心となる要望は、Coze Bot が 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 のラップ（封装）を行います。
| モデル | 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}`, // APIキーをコンテキストから取得
"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 }; // 画像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 のドキュメントセンターにて積極的に紹介し、プラグイン作者向けの専用コントリビューターページを提供いたします。
description: ComfyUIプラグイン開発のガイドライン。APIYIを活用したクラウドモデル連携のメリット、実装のヒント、および投稿・審査基準を解説します。
ComfyUI プラグイン開発の方向性と技術的ポイント
ComfyUI は、画像や動画の AI クリエイターにとって最も活発なノードベースのワークフローツールです。オープンソースの Python アーキテクチャを採用しており、コミュニティによるノードのエコシステムが非常に充実しています。
ComfyUI プラグインの核心的価値
ローカルモデルと比較して、APIYI のクラウドモデルを統合することで、以下のようなメリットが得られます：
- ローカル GPU 不要：軽量なノートパソコンでも利用可能
- Sora 2、SeeDance 2.0、Kling 2 など、ローカル環境では構築困難なクローズドソースモデルに対応
- 4K/8K の高解像度画像生成をサポート（VRAM の負荷なし）
- 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 と APIキー認証を使用すること
「精品（プレミアム）」枠の追加要件
3000円 / 5000円の報酬枠を目指す場合は、以下の追加要件を満たす必要があります：
- マルチモデル対応（主要モデル 5 つ以上）
- エラーハンドリングの完備（タイムアウト、レート制限、パラメータエラーなど）
- README の日英バイリンガル対応
- 3 つ以上のワークフローテンプレート例の添付
- 3〜5 分間の使用方法解説動画の録画
審査の加点要素
- 希少なプラットフォームをカバーする初のプラグイン（例：Dify、FastGPT など）
- コードの簡潔性と保守性（単一ファイル 500 行以下で可読性が高い）
- 継続的なアップデート計画があること
- コミュニティで自発的に利用されていること（GitHub star 20 以上）
懸賞に関するよくある質問 (FAQ)
Q1：すでに似たようなプラグインを作成済みですが、そのまま懸賞に応募できますか？
もちろんです。大歓迎です。 プラグインが「基本要件」を満たしており、APIYI (apiyi.com) の base_url および APIキー の仕様に適合していれば（軽微な修正が必要な場合があります）、そのまま審査に提出いただけます。すでに GitHub で公開されているプロジェクトで完成度が高いものは、通常そのまま「精品（プレミアム）」ランクとして審査されます。提出の際は、リポジトリのリンクと簡単な自己チェックリストを添えてください。3営業日以内に最初のフィードバックをお送りします。
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つのプラットフォーム向けプラグインセット」を投稿し、3件分の「精品」ランク報酬を獲得された方もいらっしゃいます。このような体系的な貢献は非常に歓迎いたします。
Q5：複数の人が同じ種類のプラグインを同時に提出した場合、どのように評価されますか？
「完成度の高いものを先に提出したか」と「機能の網羅性」という2つの観点から審査します。後から提出された作品であっても、機能の網羅性やコードの品質が明らかに優れている場合は、選出され、報酬が全額支払われます。選出後は両方の作品がドキュメントセンターに掲載され、ユーザーが自由に選択して利用できる形となり、「独占」が発生することはありません。
Q6：投稿してからどれくらいでフィードバックがもらえますか？
標準的なプロセスとして、3営業日以内に一次審査を行いフィードバックします。承認後、5営業日以内に報酬を支払います。 「精品」ランクの場合は追加のコード監査やドキュメント確認が必要となることがありますが、全体で10営業日を超えることはありません。進捗状況については、メールやWeChatを通じて随時お知らせいたします。
投稿プロセスと連絡先
標準的な投稿手順
作品の準備ができたら、以下の手順で提出してください。
- リポジトリの整理：GitHub/Gitee のリポジトリが公開設定になっていること、README が完備されていること、デモが実行可能であることを確認してください。
- 投稿フォームへの記入：APIYI (apiyi.com) にアクセスし、ドキュメントセンターの「開発者プログラム」ページから投稿フォームに記入してください。
- 資料の提供：リポジトリのリンク、プラグインの概要、希望する報酬形式、連絡先を記載してください。
- 審査待ち：3営業日以内に一次フィードバックが届きます。
- 修正と確定：フィードバックに基づき修正（必要な場合）を行い、採用を確定します。
- 報酬の支払い：現金は法人/個人口座へ振り込み、クレジットはあなたの APIYI アカウントへ自動的にチャージされます。
- ドキュメントへの掲載：作品が APIYI ドキュメントセンターの貢献者セクションに掲載され、あなたの署名と連絡先が記載されます。
迅速な連絡先
- APIYI 公式サイト：apiyi.com フッターの「開発者プログラム」リンク
- 公式カスタマーサポート WeChat：APIYI 公式アカウントをフォロー → メニューの「カスタマーサポートに連絡」 → 「プラグイン懸賞」と明記してください
- メールでの投稿：APIYI (apiyi.com) ドキュメントセンターで公開されている開発者用メールアドレスまでご連絡ください
よくある誤解の解消
誤解その1：「プロのエンジニアしか応募できない」
そんなことはありません。Coze のプラグイン開発は、主に JSON 設定と少量のスクリプトで構成されており、ノーコード開発者でも十分に作成可能です。N8N の Declarative Node も、高度な TypeScript の経験は必要ありません。動くものを作った実績さえあれば、どなたでも大歓迎です。
誤解その2：「完璧なものに仕上げないと提出できない」
これも間違いです。完成度は小さなものから始めて徐々に高めていくものです。まずは「単一モデル、単一機能」の最小限の機能を持つプラグインを提出してみてください。コードがクリーンで、問題なく動作し、ユーザーにとって価値があるものであれば、標準ランクの報酬を獲得できます。プレミアムランクは、より体系的な投稿を奨励するためのものですが、決して応募のハードルではありません。
誤解その3：「マイナーなプラットフォームはやる価値がない」
実際はその逆です。Dify、FastGPT、LangFlow など、まだプラグインが少ない希少なプラットフォームにいち早く対応すると、審査で加点され、プレミアムランクに入りやすくなります。すでにこれらのプラットフォームで活動されている方にとって、今回の懸賞はこれまでの蓄積を収益化する絶好のチャンスです。
まとめ
今回のオープンソースプラグイン懸賞プログラムは、本質的にコミュニティの皆さんと協力して、APIYI (apiyi.com) のモデル能力を「ツール化・エコシステム化」することを目的としています。Coze でボットを構築する人、N8N でワークフローを組む人、ComfyUI で画像生成を楽しむ人など、あらゆる開発者が Nano Banana、Sora、SeeDance、GPT、Claude といった最先端のモデルを最も簡単に利用できるようにしたいと考えています。
すでに完成品をお持ちの方には収益化の機会として、まだアイデア段階の方には、オープンソースプロジェクトを立ち上げ、個人の技術的ブランドを築くための理想的な場として活用してください。APIYI (apiyi.com) への投稿を心よりお待ちしています。また、関心がありそうなご友人にも、ぜひこの記事を共有してください。
「ユーザーから何度も質問され、カスタマーサポートが何度も同じ回答をする」といった課題を、コミュニティ全体で共有できるオープンソース資産に変えていきましょう。
📌 執筆者情報: 本記事は APIYI (apiyi.com) 運営チームが作成しました。APIYI コミュニティにおける「2026 オープンソースプラグイン懸賞計画」の正式スタートをお知らせします。投稿フォームはすでに公開されており、報酬基準は長期的に有効です。今後のアップデートにもぜひご注目ください。
