1. TOP
  2. PRODUCT
  3. Image Generate API

Image Generate APIは、Deep Convolutional Generative Adversarial Networks(DCGAN)の技術を用いてオリジナルの画像を生成するAPIです。
このモデルでは、既に自動生成された画像を合成し、新しい画像を作ることができます。
作成した画像を評価することで画像の生成に反映させることができます。
今回はネイルのデザイン生成のモデルを用意しました。

DETAIL

Image Generate APIはDCGANを使い画像を学習し、オリジナルの画像を生成します。
学習に大量の画像と時間を要するため、現時点ではユーザーがモデルを作成できる機能は提供していません。

今回公開するのはネイルのデザイン生成のAPIです。
APIから提供される画像は、4500枚以上の画像を学習したアルゴリズムから自動生成されたものです。
それらの画像を合成して新たな画像を作ることができます。
また、作成した画像を評価することで画像生成に反映させることができます。

NOTES

他人の名称・メールアドレス・住所・電話番号など個人を特定しうる情報はアップロードしないでください。
機能や画像の種類は順次追加予定ですので、試したい機能や画像などありましたら是非リクエスト下さい。

DEMO

DEMOの使用には、API KEYが必要になります。


DEMO

REFERENCE

  • Get Parameters API
  • Generate API
  • Generate Super Resolution API
  • Mix API
  • Evaluate API

Get_Parameters_API

画像を生成するために必要な数値配列(100 x 100)を返します。

エンドポイント

URL:
https://api.a3rt.recruit-tech.co.jp/image_generate/v1/getparameters
メソッド:
GET/POST

リクエストパラメータ

No. パラメータ名 説明 値サンプル 制約 必須
1 apikey APIキーを指定します AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA 半角英数字
2 callback コールバックを指定します jQueryXXXXXXXXXXXXXXXXXXXX_XXXXXXXXXXXXX レスポンス ContentType は
callback 未指定時:application/json
callback 指定時:applocation/javascript
-
3 model モデル名を指定します nail 現状は「nail」のみとなります。
4 count 取得するパラメータ数を指定します 50 最大で100個まで取得可能です。100以上を設定した場合は100個返ります。 -

レスポンスフィールド

No. 説明 値サンプル 返却条件 複数項目
1 status 処理ステータス 0 int 常に返却 -
2 message メッセージ ok string 常に返却 -
3 values 画像を生成するために必要な数値を格納した配列(100 x 100) 0.123456789,-0.123456789,・・・ list 処理正常時に返却 -

ステータスコード / メッセージ

No. status HTTP
status
message 返却条件
1 0 200 ok 正常応答
2 1000 400 apikey is null APIキー未指定
3 1001 400 apikey not found APIキーが見つからない
4 1002 400 deleted account 退会済み
5 1003 400 temporary account アカウント未承認
6 1010 400 server not found サーバが見つからない
7 1011 400 server parameter error サーバ設定エラー
8 1030 403 access deny アクセス拒否
9 1400 400 bad request リクエストパラメータが不正
10 1413 413 request entity too long リクエストパラメータの値が長すぎる
11 1500 500 internal server error サーバ処理中に想定外のエラーが発生

制限事項

GETの場合、2000文字を超えるURLはエラーになります。

Generate API

96 x 96 の画像を生成して返します。

エンドポイント

URL:
https://api.a3rt.recruit-tech.co.jp/image_generate/v1/generate
メソッド:
GET

リクエストパラメータ

No. パラメータ名 説明 値サンプル 制約 必須
1 apikey APIキーを指定します AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA 半角英数字
2 model モデル名を指定します nail 現状は「nail」のみとなります。
3 params パラメーターをcsv形式で100個指定します 0.0123456789,0.0987654321,・・・ パラメータは-1から1までの小数値

■ レスポンスフィールド

content-type:image/png

画像データ(png)

■ ステータスコード / メッセージ

制限事項

GETの場合、2000文字を超えるURLはエラーになります。

Generate Super Resolution API

384 x 384 の画像を生成して返します。

エンドポイント

URL:
https://api.a3rt.recruit-tech.co.jp/image_generate/v1/generate_sr
メソッド:
GET

リクエストパラメータ

No. パラメータ名 説明 値サンプル 制約 必須
1 apikey APIキーを指定します AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA 半角英数字
2 model モデル名を指定します nail 現状は「nail」のみとなります。
3~ v0~v99 画像生成パラメータ 0.0123456789 -1から1までの小数値

■ レスポンスフィールド

content-type:image/png

画像データ(png)

■ ステータスコード / メッセージ

制限事項

GETの場合、2000文字を超えるURLはエラーになります。

Mix API

パラメータに渡した数値を元に生成される画像の特徴を混ぜ合わせた画像を生成するために必要な100個の数値を返します。

エンドポイント

URL:
https://api.a3rt.recruit-tech.co.jp/image_generate/v1/mix
メソッド:
POST

リクエストパラメータ

No. パラメータ名 説明 値サンプル 制約 必須
1 apikey APIキーを指定します AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA 半角英数字
2 model モデル名を指定します nail 現状は「nail」のみとなります。
3 params 合成する100個の数値を改行でつなげた文字列を指定します。 0.0123456789,0.0987654321,・・・
0.0123456789,0.0987654321,・・・
20行以上指定した場合は、先頭の20行までが処理されます。

レスポンスフィールド

No. 説明 値サンプル 返却条件 複数項目
1 status 処理ステータス 0 int 常に返却 -
2 message メッセージ ok string 常に返却 -
3 values 画像を生成するために必要な100個の数値配列 0.123456789,-0.123456789,・・・ list 処理正常時に返却 -

ステータスコード / メッセージ

No. status HTTP
status
message 返却条件
1 0 200 ok 正常応答
2 1000 400 apikey is null APIキー未指定
3 1001 400 apikey not found APIキーが見つからない
4 1002 400 deleted account 退会済み
5 1003 400 temporary account アカウント未承認
6 1010 400 server not found サーバが見つからない
7 1011 400 server parameter error サーバ設定エラー
8 1030 403 access deny アクセス拒否
9 1400 400 bad request リクエストパラメータが不正
10 1413 413 request entity too long リクエストパラメータの値が長すぎる
11 1500 500 internal server error サーバ処理中に想定外のエラーが発生

制限事項

GETの場合、2000文字を超えるURLはエラーになります。

Evaluate API

生成された画像に対して「Good」「No Good」を評価します。

エンドポイント

URL:
https://api.a3rt.recruit-tech.co.jp/image_generate/v1/evaluate
メソッド:
GET/POST

リクエストパラメータ

No. パラメータ名 説明 値サンプル 制約 必須
1 apikey APIキーを指定します AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA 半角英数字
2 callback コールバックを指定します jQueryXXXXXXXXXXXXXXXXXXXX_XXXXXXXXXXXXX レスポンス ContentType は
callback 未指定時:application/json
callback 指定時:applocation/javascript
-
3 model モデル名を指定します nail 現状は「nail」のみとなります。
4 params 画像を生成するための100個の数値をカンマ区切りで指定します。 0.0123456789,-0.0123456789,・・・
5 type 「Good」「No Good」を指定します。 good
nogood

レスポンスフィールド

No. 説明 値サンプル 返却条件 複数項目
1 status 処理ステータス 0 int 常に返却 -
2 message メッセージ Thank you for your cooperation! string 常に返却 -

ステータスコード / メッセージ

No. status HTTP
status
message 返却条件
1 0 200 ok 正常応答
2 1000 400 apikey is null APIキー未指定
3 1001 400 apikey not found APIキーが見つからない
4 1002 400 deleted account 退会済み
5 1003 400 temporary account アカウント未承認
6 1010 400 server not found サーバが見つからない
7 1011 400 server parameter error サーバ設定エラー
8 1030 403 access deny アクセス拒否
9 1400 400 bad request リクエストパラメータが不正
10 1413 413 request entity too long リクエストパラメータの値が長すぎる
11 1500 500 internal server error サーバ処理中に想定外のエラーが発生

制限事項

GETの場合、2000文字を超えるURLはエラーになります。

 

SAMPLE REQUEST

  • Get Parameters API
  • Generate API
  • Generate Super Resolution API
  • Mix API
  • Evaluate API

Get Parameters API

1)正常時

リクエスト curl -X GET "https://api.a3rt.recruit-tech.co.jp/image_generate/v1/getparameters?apikey=AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA&model=nail"
レスポンス

{
  “status”:0,              
  “message”:”ok”,             
  "values":[              
    [0.0123456789,-0.0123456789,・・・],              
    [0.0987654321,-0.0987654321,・・・],              
    ・・・              
  ]             
}        

                              

2)正常時(callback パラメータ指定)

リクエスト https://api.a3rt.recruit-tech.co.jp/image_generate/v1/getparameters?apikey=AAAAAAAAAAAAAA&model=nail&callback=jQueryXXXXXXXXXXXXXXXXXXXX_XXXXXXXXXXXXX
レスポンス

jQueryXXXXXXXXXXXXXXXXXXXX_XXXXXXXXXXXXX(
  {
    “status”:0,            
    “message”:”ok”,           
    "values":[            
      [0.0123456789,-0.0123456789,・・・],            
      [0.0987654321,-0.0987654321,・・・],            
      ・・・            
    ]           
  }           
)           

                              

3)異常時(callback パラメータ未指定)

リクエスト https://api.a3rt.recruit-tech.co.jp/image_generate/v1/getparameters?apikey=AAAAAAAAAAAAAA&model=nail
レスポンス

{           
  status: 1400,           
  message: "bad request"          
}

                              

4)異常時(callback パラメータ指定)

リクエスト https://api.a3rt.recruit-tech.co.jp/image_generate/v1/getparameters?apikey=AAAAAAAAAAAAAA&model=nail&callback=jQueryXXXXXXXXXXXXXXXXXXXX_XXXXXXXXXXXXX
レスポンス

jQueryXXXXXXXXXXXXXXXXXXXX_XXXXXXXXXXXXX(
  {          
    status: 1400,             
    message: "bad request"            
  }
)              

                              

Generate API

1)正常時

リクエスト https://api.a3rt.recruit-tech.co.jp/image_generate/v1/generate?params=0.1381647438,0.0563437194,0.2595636547,0.0942027196,-0.3011170924,-0.7989380956,0.5080960393,-0.3196971714,-0.3740869164,-0.7290412188,0.1316945255,0.1118697301,-0.1783864051,-0.2264594883,-0.2385229468,0.4999575913,-0.4886583686,0.1446200907,0.1547265947,-0.4389949143,-0.0375205614,0.0202253927,0.3110108078,0.4401491284,0.3834567368,0.3646044731,0.2875115871,0.338424176,0.1915598065,0.7129570246,0.4306712151,0.4655559659,0.0172454286,-0.2128742188,-0.4188644588,-0.4574339688,-0.2630599439,0.2714809477,-0.3433758318,0.2504168451,0.2420282215,0.5716773868,-0.4428873658,-0.2352190018,-0.0290672313,0.4814511538,-0.1388861835,0.5407850146,-0.1860581189,0.724652946,0.366740942,0.3058216274,-0.6606305838,-0.0120111061,0.4301306903,0.264998734,-0.165554136,0.366689384,0.5523898005,0.201221928,0.2474626899,-0.0283741448,0.0106947497,-0.1132433414,-0.2087268531,0.2481501251,-0.0171069074,-0.6370377541,-0.0901138932,-0.2585088611,-0.6328719854,-0.1803822815,0.3138899505,-0.2621483207,0.0667387247,0.0456366166,0.3572699428,-0.685927093,0.23876445,0.1826920062,-0.5405434966,-0.3613589704,-0.3201548457,0.1244089603,0.4701940715,-0.4134089947,0.2251665443,-0.3072916567,0.5283334255,0.2196184695,0.2206944525,-0.2448488772,-0.1003204212,0.1430803686,0.6760826707,-0.2487256229,0.4444072247,0.0433442332,0.4606876075,-0.7886408567&apikey=AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA&model=nail
レスポンス

2)異常時

リクエスト https://api.a3rt.recruit-tech.co.jp/image_generate/v1/generate?&apikey=AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA&model=nail
レスポンス ※背景が白の画像

Generate Super Resolution API

1)正常時

リクエスト https://api.a3rt.recruit-tech.co.jp/image_generate/v1/generate_sr?v0=0.6991676688&v1=-0.4091431797&v2=0.6106625795&v3=-0.7363152504&v4=-0.1660559624&v5=-0.6632505059&v6=0.3073016703&v7=0.405323863&v8=0.2027759552&v9=0.2000508606&v10=-0.3474218547&v11=0.4454827607&v12=0.6042938232&v13=-0.2694275975&v14=0.2135827541&v15=0.5181920528&v16=-0.2543842793&v17=0.2909605801&v18=0.5295078754&v19=-0.3233653307&v20=0.1528743654&v21=0.5128950477&v22=-0.0421704762&v23=-0.9067621827&v24=0.5278339982&v25=-0.4887969494&v26=0.6412314773&v27=0.5110501051&v28=0.9754746556&v29=0.6819514632&v30=0.0909981579&v31=0.4869264066&v32=-0.3695546091&v33=-0.0413914546&v34=-0.1508318633&v35=-0.2875805497&v36=0.8755217791&v37=-0.0383472592&v38=0.2000472695&v39=0.1367319673&v40=0.0959844887&v41=0.1940037459&v42=-0.0195697118&v43=-0.3688637912&v44=0.5960707068&v45=-0.0498627089&v46=0.2274852246&v47=-0.5146868229&v48=0.4992122948&v49=-0.8181650639&v50=0.1576622427&v51=-0.8231081367&v52=0.0245631654&v53=-0.1743512601&v54=0.028215168&v55=0.688700974&v56=0.0508854836&v57=-0.5221051574&v58=0.516469121&v59=0.2168900669&v60=0.1325133443&v61=-0.6422541738&v62=-0.4817942679&v63=0.4978023767&v64=-0.2267246544&v65=-0.3788258135&v66=0.029756112&v67=-0.9279053807&v68=0.1658916771&v69=0.2064504921&v70=-0.3994618058&v71=0.213683337&v72=0.2673059106&v73=-0.2564420998&v74=0.0095998254&v75=0.0378263034&v76=0.7546659708&v77=-0.6261706352&v78=0.0895262212&v79=0.0497630239&v80=-0.6454447508&v81=0.4064384401&v82=-0.3041242957&v83=0.108661674&v84=-0.1782484353&v85=0.547703743&v86=-0.8689095974&v87=0.4540046751&v88=0.6728753448&v89=0.4011502564&v90=-0.3016538024&v91=-0.5318350196&v92=-0.1404686719&v93=-0.3517423272&v94=-0.0805900693&v95=-0.1297170073&v96=-0.9470382929&v97=0.2244086117&v98=0.5583221912&v99=-0.3217547834&apikey=AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA&model=nail
レスポンス

2)異常時

リクエスト https://api.a3rt.recruit-tech.co.jp/image_generate/v1/generate_sr?&apikey=AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA&model=nail
レスポンス ※背景が白の画像

Mix API

1)正常時

リクエスト curl -X POST https://api.a3rt.recruit-tech.co.jp/image_generate/v1/mix -F "apikey=AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA" -F "model=nail" -F "params=0.0742010698,0.6193314791,0.043679364,-0.0866916478,0.2772208154,0.2864432037,-0.7486010194,0.6051597595,0.2059070468,0.5211513638,0.4394703805,0.6826944351,0.276201576,0.4668067098,-0.4601705074,0.2496189326,0.2798748314,-0.1010857895,0.0535326563,0.1556125134,-0.4075187743,0.852553308,-0.0027313025,0.250007391,0.192310065,-0.1923885047,0.6818064451,-0.2259877771,0.4857340157,0.4248312414,-0.3944610655,0.3744407594,0.2319021523,-0.7508688569,-0.2555338442,0.2100462168,-0.0078944433,0.0676534846,-0.8720682263,0.169159919,0.0208145455,0.0961979628,-0.3045949936,0.8299896121,-0.3826244771,-0.41133219,0.0649349093,-0.4355618656,-0.0379124433,0.6608208418,0.2332472652,0.2476843446,-0.1573625803,0.3089381754,-0.9600954652,-0.2201569974,-0.2661848068,0.0518758744,0.1151754037,0.1859644502,-0.564330399,-0.4303122759,-0.0541421063,-0.0384934396,-0.2347171456,0.5285954475,0.5300847888,-0.4165323675,0.1114214584,-0.1910766512,-0.3254917264,0.2225733846,0.1584351957,-0.4937831759,-0.315568924,-0.3571015298,-0.2827543318,-0.3426786065,0.7090315223,0.6244841218,-0.6111884117,-0.0108016692,-0.017972609,0.1053815782,-0.336093545,0.1590118557,-0.4625523984,-0.0375539735,0.5244807005,-0.8325414062,-0.1484102756,0.7022947073,-0.1904054284,0.2602231205,-0.0368676148,-0.7002051473,0.6058142781,0.0341468863,0.3392415643,-0.002930528 -0.3838376999,-0.3215162158,0.0504115634,-0.2909923792,0.7660940289,0.4390423298,-0.7269638181,0.5984383821,0.3487185836,-0.7001783252,0.2286175787,0.2470056415,0.3078151345,0.3280475438,0.0144559843,-0.2619468868,0.849424243,-0.0331174806,0.2462749481,0.6486023068,0.4342796206,0.2411615849,-0.3225173056,0.60049963,-0.3407636583,-0.1524603963,0.5113930702,-0.568146646,0.5626887679,0.4748167992,0.3825169504,-0.6345523,0.350781858,0.6901242137,-0.0308320578,0.0199347362,0.360188961,-0.1262589693,0.3013699651,0.8008636832,-0.1530323774,0.4418942034,0.7810155749,0.1102344915,0.4276636541,0.3443911076,0.4164743125,-0.9794335365,-0.2875685394,0.0414353572,-0.4854943752,-0.6687405109,-0.9786059856,0.1082826108,0.6632872224,0.1228305995,-0.668823719,0.6032919288,-0.7195489407,-0.3203552961,0.4587358534,-0.1137570441,-0.2660945654,-0.4300107956,0.8075009584,0.3540101945,-0.2954152524,0.715262115,0.0821448117,-0.3847413957,0.5684716105,0.2341498286,-0.6979330182,0.1160598472,0.3123908043,-0.5655986667,0.2151326835,-0.386580795,0.8241744637,0.4797146916,-0.5314735174,-0.4328704774,-0.8172789216,-0.7965368032,-0.4305382371,0.55815804,-0.1090389043,0.4433044791,0.6644215584,-0.4055427909,0.6967671514,0.8551778197,0.0591700263,0.0960273072,0.2813111544,-0.3831872344,-0.2792854011,-0.3651403189,-0.4012022913,-0.3969690204"
レスポンス

{
  “status”:0,              
  “message”:”ok”,             
  "values":[0.0123456789,-0.0123456789,・・・]             
}  

                              

2)異常時

リクエスト https://api.a3rt.recruit-tech.co.jp/image_generate/v1/mix?apikey=AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA&model=nail&params=0.0123456789,-0.0123456789,・・・
レスポンス
         
{
  status: 1400,
  message: "bad request"          
}

                              

Evaluate API

1)正常時

リクエスト curl -X GET "https://api.a3rt.recruit-tech.co.jp/image_generate/v1/evaluate?apikey=AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA&model=nail&type=good&params=0.0123456789,-0.0123456789,・・・"
レスポンス

{
  “status”:0, 
  “message”:”Thank you for your cooperation!”
}                    

                              

2)正常時(callback パラメータ指定)

リクエスト curl -X GET "https://api.a3rt.recruit-tech.co.jp/image_generate/v1/evaluate?apikey=AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA&model=nail&type=good&callback=jQueryXXXXXXXXXXXXXXXXXXXX_XXXXXXXXXXXXX&params=0.0123456789,-0.0123456789,・・・"
レスポンス

jQueryXXXXXXXXXXXXXXXXXXXX_XXXXXXXXXXXXX(
  {
    “status”:0,            
    “message”:”Thank you for your cooperation!”
  }           
)                           

                              

3)異常時(callback パラメータ未指定)

リクエスト curl -X GET "https://api.a3rt.recruit-tech.co.jp/image_generate/v1/evaluate?apikey=AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA&model=nail&type=good&params=0.0123456789,-0.0123456789,・・・"
レスポンス

{           
  status: 1400,           
  message: "bad request"           
}                   

                              

4)異常時(callback パラメータ指定)

リクエスト curl -X GET "https://api.a3rt.recruit-tech.co.jp/image_generate/v1/evaluate?apikey=AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA&model=nail&type=good&callback=jQueryXXXXXXXXXXXXXXXXXXXX_XXXXXXXXXXXXX&params=0.0123456789,-0.0123456789,・・・"
レスポンス

jQueryXXXXXXXXXXXXXXXXXXXX_XXXXXXXXXXXXX(
  {
    status: 1400,           
    message: "bad request"           
  }
)